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This publication contains preliminary 
information on how to apply and use the IBM 
System/360 Operating System for remote mes- 
sage processing and how to use the control 
program for performing the input/output 
operations of a data communications system. 

Guidance is provided for problem pro- 
gramming within the system. Descriptions 
of applicable macro-instructions, suggest- 
ing how, when, and where to use them, are 
also included. 







PREFACE* 



This publication contains preliminary 
information on planning and implementing a 
system for remote message handling and/or 
processing under the System/360 Operating 
System. 



IBM System/360 Operating System: Assem- 
bler Language, Form C28-6514 



IBM System/360 Operating System; Data 
Management , Form C28-6537 



Completion of a basic course in program- 
ming Computing Systein/360 is a prerequisite 
to using this publication. It is also 
required that the reader be familiar with 
the overall programming concepts and termi- 
nology introduced in the following publica- 
tions : 



IBM System/360 Operating System: Control 
Program Services, Form C28-6541 



It is suggested that the reader be 
familiar with the following additional pub- 
lications: 



IBM System/360 Operating System: Intro- 
duction , Form C28-6534 

IBM System/360 Operating System: Con- 
cepts and Facilities , Form C28-6535 

IBM System/360 Operating System: Job 
Control Language , Form C28-6539 



IBM 27 01 Data Adapter Unit, Principles 
of Operation , Form A22-686U 



IBM 2702 Transmission Control , Form 
A22-6846 
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INTRODUCTION 



System/360 is designed to provide a 
variety of programming and data processing 
services that can be requested and used 
from a local or a remote location, or both. 
Any of the services provided by System/360 
Operating System for local use are also 
available for use from geographically dis- 
persed locations via telecommunications 
networks. In addition, the operating sys- 
tem can also provide services that are 
peculiar to telecommunications, such as 
message switching and data collection. 
This publication describes how the opera- 
ting system can be extended to remote 
locations in order to: 

• Decrease the response time to individ- 
ual requests for services. 

• Share the extensive programming and 
data processing facilities of 
System/360 with other locations. 

• Make the system an integral and more 
natural part of the activity it sup- 
ports. 

Depending on the specific application, 
the operating system can be used to process 
messages from remote locations exclusively, 
process messages and execute local jobs 
concurrently, or alternate between the 
processing of messages and the executing of 
local jobs. 

To extend the operating system for tele- 
communications applications, a queued and a 
basic telecommunications access method are 
available for controlling the sending and 
receiving of messages to and from remote 
terminals. The queued telecommunications 
access method (QTAM) can be used in a 
variety of applications ranging from a 
message switching application to a high- 
volume inquiry or transaction processing 
application such as a banking or airline 
reservation system. The basic 
telecommunications access method (BTAM) is 
designed for limited applications, which do 
not require extensive message control 
facilities. Either access method (QTAM or 
BTAM) can be used to receive messages from 
and send messages to the following terminal 
devices: 

• IBM 1030 Data Collection System. 

• IBM 1050 Data Communications System 
(leased line or dial service) . 

• IBM 1060 Data Communications System. 

• AT&T 83B2 Selective Calling Stations. 

• Western Union Plan 115A Outstations. 

• Common Carrier (8-level code) TWX Sta- 
tions; e.g., ATST Model 33 or 35 Tele- 
typewriter Terminal (dial service). 



These devices can be attached through a 
control unit (the IBM 2701 Data Adapter 
Unit or the IBM 2702 Transmission Control) 
to the multiplex channel of the System/360 
Central Processing Unit (CPU) as illustra- 
ted in Figure 1. 



QUEUED TELECOMMUNICATIONS ACCESS METHOD 



The QTAM facilities include a comprehen- 
sive set of message control and editing 
routines that relieve the programmer 
assigned to the telecommunications applica- 
tion of the detailed, intricate, and spe- 
cialized programming normally required for 
such an application. These routines can be 
assembled into an integral message control 
program , which is designed to meet the 
exact requirements of an installation. 

To simplify and speed the construction 
of a message control program, a special 
message control language is provided, by 
QTAM. This language is compiled by an 
System/360 Operating System assembler pro- 
gram and consists of a set of macro- 
instructions and parameters. The language 
is specifically designed for easy use in 
describing the line procedures, line 
configurations, buffer lengths, polling 
procedures, and types of message editing 
required for a particular application. 
Using the message control language, a com- 
plete message control program for a Tele- 
processing application can be described, 
and compiled in days, rather than in 
months . 

The message control program serves as an 
intermediary between the remote terminals 
and any message processing programs. It 
enables the terminals to be referred to 
indirectly, in much the same way as local 
input/output devices are referred to, using 
standard language statements, such as GET, 
PUT, OPEN, and CLOSE. Detailed functions, 
such as the actual sending or receiving of 
messages, buffer allocating, message rout- 
ing, message code translating, message for- 
matting, and error checking, are performed 
automatically by the message control pro- 
gram. 

The message control program may be exe- 
cuted as a separate task independently of 
and concurrently with any message process- 
ing programs. As input messages are 
received, they are routed (after transla- 
ting, checking, etc., and any editing pro- 
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Figure 1. Telecommunications System - Conceptual Diagram 
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Figure 2. Inquiry Application - Simplified Block Diagram 



vided by the user) to one or more message 
queues in main or direct-access storage. 
Message processing programs take them from 
there as in ordinary processing. When a 
message is to be sent to a terminal by a 
processing program, it is placed on an 
output queue in main or direct-access stor- 
age. The message is then sent by the 
message control program to its destination. 
In the case of message switching, a message 
processing program may not be required — 
the message control program can route an 
inbound message directly to an appropriate 
output queue. 

A telecommunications job can be entered 
into the system in the same way as any 
other job. The job scheduler of the opera- 
ting system, therefore, can be used to 
allocate any input/output devices and 
direct-access storage space required for 
message logs and message queues, and to 
prepare and schedule the job for process- 
ing. A message control program and any 
message processing programs associated with 
it can be entered into the system as 
separate jobs or they can be combined and 
entered as a single job. With some opera- 
ting system configurations, more than one 
job can be run concurrently. Therefore, 
other jobs can share the physical resources 
of the system with a telecommunications 
job, and thereby improve efficiency, par- 
ticularly during periods when message traf- 
fic is low. 

A message control program can be 
designed for one or more types of applica- 
tions including inquiry (or transaction) 
processing, data collection, job process- 
ing, and message switching. Each of these 
is briefly described below followed by a 
brief explanation of the procedure required 
to construct a message control program for 
one or more of the applications. 



INQUIRY PROCESSING 



Inquiry processing is an application in 
which inquiries in the form of messages are 
received from a number of remote terminals 
and are routed by the message control 
program to one or more input queues. The 
messages are picked up from the input queue 
and processed by a message processing pro- 
gram. After the message is processed, a 
reply can be sent to the terminal from 
which the inquiry originated or to any 
other terminal. The reply is placed on an 
output queue by the message processing 
program and transmitted to the terminal by 
the message control program. 

With this type of application, the sys- 
tem can directly participate in and control 



a variety of commercial and scientific 
activities as they are carried on. For 
example, the system may be used to service, 
from a central location, a geographically 
dispersed banking activity. In such a 
system, master files that contain account 
records for thousands of depositors are 
stored in direct-access storage. By enter- 
ing pertinent data into the system, tellers 
at remote locations can check balances, 
update passbook records, and handle similar 
transactions, all within a few seconds. 

The message processing program that res- 
ponds to inquiries must be designed for the 
specific application. In designing the 
program, all of the facilities of the 
operating system are available including 
the language processors, the service pro- 
grams, and the data and task management 
facilities. 

The processing of messages can be per- 
formed sequentially as a single task or 
more than one message can be processed 
concurrently. Figure 2 is a simplified 
block diagram of an inquiry application in 
which the messages are processed as two 
separate tasks. As the routine for task B 
is processing one message, the routine for 
task A may be processing another message 
while the next message is being obtained 
from an input queue and a reply to a 
previous message is being placed on an 
output queue. 

In many inquiry applications, a message 
processing program requires access to data 
and routines stored in local direct-access 
storage. In such an application, it would 
be possible to process several messages 
concurrently as separate tasks. Conse- 
quently, as the processing of one message 
is delayed while access is being gained to 
direct-access storage, another message 
could be processed. By processing several 
messages concurrently, the total message 
throughput of the system can be signifi- 
cantly increased. Since many of the mes- 
sages in such an application would often 
require identical processing, a single pro- 
gram in main storage could be used to 
perform each of several concurrent tasks, 
and thereby save main storage space and 
program loading time. 

Because the message control program and 
the message processing program are executed 
as separate tasks in an inquiry applica- 
tion, an System/360 Operating System con- 
trol program is required that can control 
concurrently more than one data processing 
task. The general-purpose, multiple task- 
management facilities of the control 
program are particularly appropriate to 
this type of application. They enable the 
system to be used for many high-message- 
volume applications that would otherwise be 



Introduction 



impractical without a specially designed 
control program. 



DATA COLLECTION 



Data collection is an application in 
which messages received from one or more 
terminals are collected and stored for 
later processing. Data collection can he 
performed completely by the message control 
program. Messages to be collected can be 
routed to an input queue on a direct-access 
storage device or logged on a sequential 
storage device, such as magnetic tape. 



MESSAGE SWITCHING 



Message switching is an 
which messages received 
terminal are sent to one 
remote terminals. Like 
message switching can be 
pletely by the message 
When an incoming message is to be switched, 
it is routed to an output (destination) 
queue instead of an input queue. If neces- 
sary, the messages can be logged and func- 
tions, such as time and date stamping, 
sequence numbering and checking, and desti- 
nation code validating, can be performed by 
the message control program before the 
message is transmitted. 



application in 
from one remote 

or more other 
data collection, 

performed corn- 
control program. 



JOB PROCESSING 



CONSTRUCTING A MESSAGE CONTROL PROGRAM 
WITH THE QTAM LANGUAGE 



Job processing is an application in 
which jobs like those that are entered into 
the system locally are received from one or 
more remote terminals. The jobs may be 
entered at the remote location via input 
devices such as keyboards, punched card 
readers, and tape units. Output from a job 
can be directed to the terminal from which 
the job originated, transmitted to one or 
more other terminals, printed or otherwise 
processed by the operating system, or 
cataloged and stored (for later retrieval) 
in the operating system library. Data 
which is processed by the job can either be 
a part of the job itself or can be 
retrieved from the system library. 

All of the operating system facilities, 
such as the language processors, the ser- 
vice programs, and the data, job, and task 
management facilities, that are available 
to the local programmer are also available 
to the programmer at the remote location. 
The operating system, in fact, is specifi- 
cally designed for use at remote locations 
as well as for local use. The data catal- 
oging and management facilities of the 
system, for example, enable individual pro- 
grammers to compile, store, test, update, 
recompile, link, and execute programs with- 
in the confines of the operating system 
without resorting to the use of punched 
cards or without specific knowledge of the 
input/output configuration of the system. 

Jobs that are received from remote loca- 
tions are placed by the message control 
program on an input queue in direct-access 
storage in a format acceptable to the job 
scheduler. The actual processing of the 
jobs can be performed later, or the jobs on 
the input queue can be read and scheduled 
by the job scheduler as other jobs are 
being added to the input queue. 



To construct a message control program 
tailored to one or more specific applica- 
tions, a programmer must provide three 
general types of information: data set 
definitions, control information, and line 
procedure specifications. Each type of 
information is described in the following 
sections. 



Data Set Definition 



A data set must be defined for each data 
set referred to by the message control 
program. This is done by means of the data 
control block (DCB) macro-instruction and 
data definition (DD) control statements 
that are entered into the system when the 
telecommunications jod is scheduled for 
execution. A DCB macro-instruction must be 
provided in the message control program for 
the following: 

• Each group of communications lines that 
are to be referred to by the message 
control program. Each line group can 
consist of any number of communications 
lines provided they have certain char- 
acteristics in common. 

• The combined input and output queues 
that are to be established in direct- 
access storage. If the input and 
output queues are in main storage, a 
DCB macro-instruction is not required 
for the queues. 

• Each message log, if any. 

A DCB macro-instruction must also be 
provided in each message processing pro- 
gram, if any, for a queue from which 
messages are to be obtained and a queue to 
which messages are to be sent. 
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Control Information 



In addition to the data set definitions, 
the programmer must supply, in the form of 
macro- instructions, control information 
that is used by the message control program 
to control the sending and receiving of 
messages. The control information consists 
of the following: 



• The code name and address of each 
terminal together with related informa- 
tion, such as any special distribution 
lists for sending a message to more 
than one terminal. 

• The code name of each queue to which 
incoming messages are to be sent. The 
messages can be either in main or 
direct-access storage. If extremely 
fast response is required, an option 
can be specified which causes messages 
for one or more input queues to be 
routed directly to the processing pro- 
gram, bypassing the direct-access stor- 
age queues. 

• A polling list for each line that 
indicates the order in which the termi- 
nals are to be polled. 

• The size and number of main storage 
buffers that are to be used for trans- 
mitting and receiving messages to and 
from the terminals, and for enqueueing 
and dequeueing messages. Buffers are 
automatically and dynamically allocated 
from a common buffer pool in accordance 
with immediate requirements. 



Line Procedure Specifications 



The procedure to be followed by a mes- 
sage control program, when operating upon 
messages, is defined by a series of macro- 
instructions called a line procedure 
specification (LPS) . A line procedure 
specification is required for each communi- 
cations line group unless similar proce- 
dures are to be followed in servicing the 
messages of more than one line group. 

Two types of macro-instructions are used 
to specify a line procedure: functional and 
delimiter. The functional macro- 
instructions, in general, perform specific 
operations on messages. The delimiter 
macro-instructions perform initialization 
procedures, and classify and identify 
sequences of functional macro-instructions 
so that control can be directed to a 
required sequence based on whether a mes- 
sage is being sent or received and whether 
the complete message or just the message 
header is to be operated upon. 



The operations that can be performed by 
the functional macro-instructions include 
the following: 

• Performing message editing functions , 
such as code translating, time and date 
stamping, sequence checking, source and 
destination code validating, sequence 
numbering, and message length checking. 

• Routing messages to specified queues 
based upon destination codes. 

• Maintaining a log of messages on an 
auxiliary storage device. 

• Checking for errors in message trans- 
mission. 

• Initiating corrective action when an 
error is detected. 

• Rerouting, canceling, or intercepting 
transmission of messages in error. 

The functional macro-instructions in a 
line procedure specification are divided by 
delimiter macro-instructions into two major 
sections: a receive section consisting of 
macro- instructions that are to operate on 
incoming messages and a send section con- 
sisting of macro-instructions that are to 
operate on outgoing messages. Each major 
section is further subdivided into sections 
consisting of macro-instructions that are 
to operate on the header portion of a 
message and macro-instructions that are to 
operate on both the header and the text 
portions of a message. A third optional 
subsection may also be included in each 
major section, which consists of functional 
macro- instructions that perform certain end 
functions such as testing for errors and 
performing error procedures. 

Functional macro-instructions in a mes- 
sage header subsection that operate on 
specific fields of the message header can 
be arranged in any order. Therefore, the 
programmer has complete freedom in defining 
the order of the message header fields. 

Some of the functional macro- 
instructions are designed for use in either 
the send section or the receive section, or 
both. Most of the macro-instructions are 
optional. Many of these can operate either 
upon all messages unconditionally or 
selective messages, as indicated by a char- 
acter code in the message itself. In 
addition, any optional portion of the line 
procedure can be bypassed for a particular 
message based on a character code in the 
message. 

A programmer can, if he chooses, use the 
assembler language to insert nis own in- 
line coding or his own macro-instruction 
into the line procedure specification, 
either as a substitute for an optional 
macro-instruction provided by IBM or in 
order to provide additional functions. The 
programmer also has the option of speci- 
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fying that his own code conversion tables 
be used. to translate messages instead of 
the optional code conversion tables sup- 
plied by IBM. 

An optional macro-instruction is provid- 
ed that can be used to direct control, at 
different points in the line procedure 
specification, to an out-of-line subroutine 
supplied either by IBM or by the user. The 
transfer of control can be either uncondi- 
tional or conditional depending on the 
presence of a character code in a message. 
IBM routines, which perform the following 
functions, are provided for use with the 
optional macro-instruction: 

• Assigning priority to a message based 
on an alphameric character in the mes- 
sage header. The priority order of the 
characters that define priority corres- 
pond to the standard collating 
sequence. 

• Holding the communications line open 
until a complete message has been 
received and a reply has been sent. 
This subroutine may be used for a 
"conversational" type of application. 

• Routing message segments to their des- 
tination before the entire message has 
been received. 



MESSAGE PROCESSING MACRO- INSTRUCTIONS 



In addition to the macro-instructions 
that are provided for in the message con- 
trol program, a set of macro-instructions 
is provided for use in a message processing 
program or other processing programs. The 
following macro-instructions are included 
in the set: 

• The GET macro-instruction, which 
obtains the next sequential record, 
message segment, or message from the 
input queue. 

• The PUT macro- instruction, which places 
a message, message segment, or record 



into the output queue. 

The RETRIEVE macro-instruction , which 
retrieves a specific message segment 
from a specific queue. 

The STOPLN and STRTLN macro- 
instructions, used to deactivate and 
activate, respectively, a communica- 
tions line. 

Macro-instructions which can be used to 
copy a terminal table, a polling list, 
or a queue status report list into a 
work area of main storage, as well as 
macro-instructions which can be used to 
change entries in the terminal table 
and the polling list. These macro- 
instructions can be used to modify the 
status or operating characteristics of 
the message control program. They may 
be used in a program that receives and 
analyzes operator messages entered via 
a local terminal. 



BASIC TELECOMMUNICATIONS ACCESS METHOD 



The BTAM facilities are designed chiefly 
to provide the basic tools required to 
construct a telecommunications program. 
These include facilities for creating 
terminal lists and performing the following 
operations: 

• Polling terminals. 

• Answering. 

• Receiving messages. 

• Allocating buffers dynamically, 
o Addressing terminals. 

• Dialing. 

• Writing buffer chains. 

• Changing the status of terminal lists. 

BTAM may be used instead of QTAM at 
installations that have few communications 
lines and limited requirements for inquiry 
processing or data collection. It also may 
be used at a large Tele-processing instal- 
lation where the user chooses to construct 
his own message control program rather than 
use the one provided with QTAM. 
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QUEUED TELECOMMUNICATIONS ACCESS METHOD 



QTAM is one of the data management 
facilities provided in System/360 Operating 
System. It is specified as a high-level 
macro-instruction language that enables 
operation of communications lines in a 
manner similar to directly attached 
input/output devices. 



Queues must be specified for various 
processing tasks and destination terminals. 
These queues are the primary connection 
between the user-supplied message proces- 
sing tasks and the QTAM message control 
task. Message flow (Figure 3) can be 
considered in the following seven steps: 



Selection of appropriate macro- 
instructions within QTAM provides a system 
that performs the following: 

• Polls terminals (contacts remote 
terminals to request that they send 
messages) . 

• Receives messages from terminals. 

• Addresses terminals (contacts terminals 
to request that they receive messages) . 

• Sends messages to terminals. 

o Provides storage allocation for message 
buffering. 

• Performs such message editing functions 
as code translating, time and date 
stamping, sequence checking, source and 
destination code validating, sequence 
numbering, and message length checking. 

• Routes messages to specified queues 
based upon destination codes (a queue 
may be used for a processing task, a 
terminal, or a group of terminals) . 

• Queues messages either on a direct- 
access storage device (to provide for 
handling long messages without 
requiring large buffers) or in main 
storage. 

• Maintains a log of messages on an 
auxiliary storage device. 

• Checks for errors in message transmis- 
sion. 

• Initiates corrective action when an 
error is detected. 

• Reroutes messages. 

• Intercepts transmission of messages in 
error. 

• Cancels messages that contain an error. 

Message flow,, as controlled by QTAM, is 
illustrated in Figure 3. It involves 
input/output buffering and message 
queueing. Euffering is dynamically handled 
by QTAM. A user need only specify the 
number of buffers and the length of each 
buffer to be used. (Refer to "Buffer 
Assignment.") If the supply of buffers is 
depleted during system operation, an error 
indication on one or more lines will 
result. For this reason, a user must 
specify sufficient buffer space to meet his 
system requirements. 



1. The input message, consisting of mes- 
sage header and text, is prepared at 
the remote source terminal. The head- 
er portion contains source terminal 
code, destination codes, message 
sequence number, and message priority 
information. When the source terminal 
is polled, the message is sent to the 
computer via a communications line. 

2. The variable length message enters the 
computer and is placed in user- 
defined, fixed-size buffers. As many 
buffers as are necessary to handle the 
message are filled. QTAM attaches a 
header prefix that contains control 
information (24 bytes) and queueing 
information (8 bytes). The header 
prefix and the message header must all 
be contained within the first buffer. 
Each of the remaining buffers assigned 
to the message has a text prefix that 
contains queueing information (8 
bytes) and control information (14 
bytes) . These buffers also contain 
the message text. As soon as each 
buffer is filled, QTAM performs such 
user-selected functions as code 
translating, routing, time and date 
stamping, and sequence checking. 

3. When a message requires additional 
processing, each segment is sent to a 
process queue. This queue may be 
either in main storage or on a direct- 
access storage device. 

4. The user's message processing program 
can issue a GET macro-instruction to 
obtain messages, segments, or records 
from the process queue. The message 
obtained by the processing program 
contains a modified prefix (4 bytes) . 
(Refer to "GET Macro-Instruction.") 
This message can then be processed. A 
user in his processing program can 
send replies by forming a message with 
the 4-byte prefix and by issuing a PUT 
macro-instruction. The message is 
then placed on an output (destination) 
queue and handled as in message 
switching (Step 5). 
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Figure 3. Telecommunications Access Method - Message Flow Diagram 



5. In message switching, each message 
segment is routed to a destination 
queue. This queue may be either in 
main storage or on a direct-access 
storage device. 

6. Message segments are retrieved from 
the output queue on a first-in-first- 
out basis within priority groups. 
These segments pass through QTAM for 
such functions as code translating, 
time and date stamping, and logging. 
The segment is then ready to be sent 
to the terminal. 

7. Message segments are stripped of 
header and text prefixes and sent to 
the terminal as one continuous mes- 
sage. 

In order to communicate with QTAM, mes- 
sage processing programs must use the GET, 
PUT, and RETRIEVE macro-instructions de- 



scribed under "Message Processing Tasks." 
Other functions of the user programs for 
message processing may be written using the 
Assembler Language (refer to IBM Operating 
System/360; Assembler Language ) or a higher 
level language compiler that produces an 
equivalent object code. 

There may be one or more individual 
message processing tasks. A message pro- 
cessing task can obtain a message from a 
queue, process the message, and place a 
message or result in an output queue. The 
programmer need not be concerned with the 
functions being performed by the message 
control task and the QTAM device handling 
routines. The message processing task, 
however, cannot be executed without the 
message control task. Problem programs may 
be written as if they were using sequential 
input/output devices. 
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Message processing programs that use 
directly attached input/output devices may 
use the macro- instruction language of the 
appropriate access method. 

System status macro-instructions are 
provided to enable a user to obtain infor- 
mation that concerns the terminal polling 
sequence, the terminal table entries, and 
the present status of message queues. 
Macro-instructions can be used in a message 
processing task to extract system status 
information and to change the system sta- 
tus. 

In specifying QTAM for his system, the 
user must provide information in the fol- 
lowing areas: 

• Data set definition - The user must use 
macro-instructions provided by 
System/360 Operating System and QTAM 
control statements to define the data 
sets used in his telecommunications 
system. 

• Control information - The user must 
provide detailed information, in the 
form of tables and lists, concerning 
the terminals in the system, the 
desired sequence of polling for each 
line, the queueing technique, and the 
message buffers provided. 

• Message control task - The user must 
select and place into order macro- 
instructions provided by QTAM to create 
the message control task. These macro- 
instructions perform the message code 
translating, the editing, the format 
checking, the logging, and the routing 
functions. 

• Message processing tasks - The user 
must write the programs necessary to 
meet his requirements. These programs 
operate as one or more individual 
tasks. 

Wherever macro-instructions are de- 
scribed in this publication, the following 
conventions are used to illustrate the 
coding format: 

• Upper case letters and punctuation 
marks (except for the brackets and 
braces described) represent information 
that must be coded exactly as shown. 

• Lower case letters and words are 
generic terms that represent informa- 
tion to be supplied; i.e., a substitu- 
tion must be made when coding a param- 
eter or option so represented. 

• Information within brackets [ ] rep- 
resents an option that can be either 
included or omitted entirely, depending 
upon program requirements. 

• When options are enclosed in braces { } 
one of the enclosed options must be 
included, and the others omitted 
according to the programmer's discre- 



tion. One of several options enclosed 
in the braces may be underlined, indi- 
cating that the operating system auto- 
matically assumes this option if the 
parameter is omitted. 
• An ellipsis (...) indicates that a 
variable number of items may be listed. 



DATA SET DEFINITION 



Before a telecommunications system can 
use QTAM, the data sets of the system must 
be specified. A description of the four 
types of data sets that can be associated 
with QTAM and the means by which they may 
be defined follows. 

Four types of data sets are supported 
directly by the QTAM message control task: 

• Data sets that consist of messages 
transmitted via communications lines. 
One or more data sets of this type are 
required. 

• Data sets that consist of message 
queues on direct-access storage devices 
(IBM 2302 Disk Storage, IBM 2311 Disk 
Storage Drive, and IBM 231U Direct 
Access Storage Facility) . The require- 
ment for this type of data set depends 
on the requirements of the user. 

• Data sets that consist of message logs 
on a secondary storage device. The 
requirement for this type of data set 
depends on the requirements of the 
user. 

• Data sets that consist of queues of 
messages. This type of data set is 
used in the message processing tasks. 

Available sources for information con- 
cerning a data set include the data control 
block (DCB) macro-instruction, the data 
definition (DD) statement, and the data set 
label (DSL) . The DCB macro-instruction 
provides for assembly time definition of a 
data control block. This data control 
block is the primary source of data set 
characteristics and control information for 
the QTAM routines. The DCB macro- 
instruction reserves space for the data 
control block and assigns values to those 
fields for which the user provides 
parameters. 



Note: Information provided in the DCB 
macro-instruction takes precedence over 
information provided in the DD statement or 
the DSL. For general information concern- 
ing the DD statement and the DSL, refer to 
the publications IBM Operating System/360: 
Job Control Language and IBM Operating 
System/360: Data Management . 
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A data control block provides control 
information for a communications line 
group, where the line group consists of any 
number of lines with the following charac- 
teristics: 



All lines are associated with the same 
type of terminal devices. (For this 
purpose, IBM 1050 and IBM 1060 Data 
Communications Systems may be treated 
as the same device.) 

All lines require the same number of 
buffers to be requested before they are 
actually needed. 

All lines share the same line procedure 
specifications (LPS). 

All lines operate under the same rela- 
tive priority specification. 
All lines operate with the same polling 
interval. 

The relative address of the device- 
address field is the same for all 
terminal table entries associated with 
the lines. 

None of the lines is defined in another 
line group. 



Certain information that describes a 
data set must be supplied through DD 
statements. Each communications line 
group, direct-access queue and message log 
requires device allocation information. In 
addition, the direct-access queue requires 
space allocation on a direct-access storage 
device. 



Each communications line group requires 
one or more DD statements that specify 
which communications lines are to consti- 
tute that line group. This is specified in 
the UNIT operand of the statement. It may 
be specified in either of two ways : 

1. //ddname DD UNIT=(name,n) 

where name is the name of a list that 
was created at system generation time 
and n is the number of lines in the 
list- This list contains a descrip- 
tion of each line. The order in which 
the lines appear in the list deter- 
mines the relative line number for 
each. 

2. //ddname DD UNIT=(name 1 ,n 1 ) 

DD UNIT=(name 2 ,n 2 ) 



DD UNIT=(name ,n ) 

where x lists are named and are con- 
catenated in the order in which they 
are specified, and where n is the 
number of lines defined in each list. 



If direct-access queueing is to be used, 
the user must acquire space for the queue 
(using the DD statement) . The user must 
also execute a utility program so that the 
acquired space may be used for a fixed 
record length (equal to the buffer size to 
be used by QTAM) . This data set must then 
be cataloged and identified to the message 
control task on the DD statement associated 
with the direct-access queue. 



One input data control block must be 
created for each queue from which messages 
are to be obtained by the message process- 
ing tasks. To obtain a message from a 
queue, the message processing task refers 
to the data control block associated with 
that queue. 



At least one output data control block 
must be created for each message processing 
task from which messages are to be sent. 
Since all destinations may be referred to 
by using one data control block, the need 
for additional data control blocks for 
output is eliminated. 



Data Control Block (DCB) Macro-Instruction 



The DCB macro-instruction causes the 
creation of a data control block. A data 
control block must be created for each 
communications line group, direct-access 
message queue, processing program message 
queue, and message log. 



r t t 1 

| Name | Operation! Operand | 

y 1 + ^ 

j dcbname | DCB | keyword parameters | 

L JL L J 



keyword parameters 

Indicate the parameters listed in 
Tables 1 through 5. When an alternate 
source code is shown with a parameter, 
it indicates the other sources of 
information that concern the parame- 
ter: C indicates the parameter that 
may be specified in a DD statement; D 
indicates the parameter that may be 
supplied from a DSL; and E indicates 
the parameter whose value may be sup- 
plied at any time up to and including 
the DCB exit provided at open time- 
(Refer to the publication IBM Operat- 
ing System/36 0: Control Program Servi- 
ces. ) 
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Table 1. 
r 



Communications Line Group DCB Macro-Instruction Keyword Parameters 



Keyword 
Parameter 



t r 

Alternate 
Source 
Code 
+- 



Parameter Description 



DDNAME=name 



name 



Specifies the name that appears in 
associated with the data control block. 



the DD statement 



DSORG=CX 



CX 



4- 



Identifies the data set organization as that of a communi- 
cations line group. 



MACRF=(G,P) 



(G,P) 



Specifies that access to the line group is 
with the GET and PUT macro-instructions. 



to be gained 



CPOLL=(d lf 
d 2 , . . . ,d n ) 



(djLfda, ,d n ) 

Specifies n symbolic addresses of polling lists, where n 
is the number of lines in the line group. Each symbolic 
address is the same as the name in the POLL macro- 
instruction used to define the list for that line. The 
symbolic addresses must be specified in the same order as 
the lines are specified in the DD statement (refer to IBM 
Operating System/360: Job Control Language ) . If a line is 
used for output only # the address of a polling list with 
no terminal entries must be specified. Any number of 
output-only lines may reference this address. 



BUFRQ=n 



C,E 



Specifies the number of buffers to be requested before 
they are actually needed to receive data from a line, 
where 2<n<255. The number should be specified such that 
buffer requests may be scheduled sufficiently in advance 
to ensure that a buffer will be available when it is 
actually needed for data. The primary factors to be 
considered in determining the value of this number are the 
line speed, the size of the buffer pool versus the average 
number of buffers that are active at any one time, the 
size of each buffer versus the average size of a 
transmitted block, and the total system loading. 



Note : BUFRQ=2 will be assumed if no value is provided through 

ction or an alternate source, or if a value 
ded. 



the DCB macro-instru< 
less than 2 is provic 



INTVL=t 



C, E 



Specifies the 
between passes 
all of the t 
have been polle 
before polling 
The primary pur 
nonproductive 
frequency of me 
line group. 



number of seconds of intentional delay 
through a polling list, where t<255. When 
erminals on a polling list for a given line 
d, there will be a delay of t seconds 

is restarted at the beginning of the list, 
pose of the polling interval is to limit 
polling. It may also be used to limit the 
ssage transmissions from a highly active 



Note : INTVL=0 will be assumed if no value is provided through 
the DCB macro-instruction or an alternate source. 

(continued) 
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Table 1. Communications Line Group DCB Macro-Instruction Keyword Parameters (continued) 
r t t 1 



b-- 



Keyword 
Parameter 



t T 

Alternate 

Source 

Code 



-I- 



Parameter Description 



CPRI=R 
CPRI=E 
CPRI=S 



C,E 



R,, E, or S 

Indicates the relative priority to be given to sending and 
receiving operations, as follows: 

R - receiving has priority over sending. Output message 
will be sent on a given line only during a polling 
interval. 

E - receiving and sending have equal priority. After 
each full polling sequence on a given line, all 
output messages queued for that line will be trans- 
mitted. 

S - sending has priority over receiving. After polling 
each individual terminal on a line, the line is made 
available for outbound messages and the next terminal 
is polled only when there are no output messages in 
queue for that line. 

Note : CPRI=S will be assumed if no value is provided through 



the DCB macro-instruction or an alternate source. 



ACLOC=n 



Specifies the relative address of the device-address field 
in a terminal table entry relative to the first byte of 
the terminal table entry (defined by the TERM 
macro-instruction), where n<255. If no value is provided 
through the DCB macro-instruction or an alternate source, 
the job will be terminated. 



CLPS=addr 



addr 



Specifies the symbolic address of the start of the line 
procedure specifications. If no value is provided through 
the DCB macro-instruction or an alternate source, the job 
will be terminated. 



[EXLST=addr] 



addr 



Specifies the symbolic address of the exit list. (Refer 
to Appendix D of the publication IBM Operating System/360: 
Control Program Services . ) 



Table 2. Direct-Access Message Queue DCB Macro-Instruction Keyword Parameters 



*T T" 

| Alternate | 

J Source j 

| Code | 

-+ +■ 



Keyword 
Parameter 



Parameter Description 



DDNAME=name 



+- 

DSORG=CQ | 



name 



Specifies the name that appears in the DD statement 
associated with the data control block. 



+- 

MACRF=(G,P) j 
I 

I 

±. 



CQ 



4- 

I (G,P) 



Identifies the data set organization as that of a direct- 
access message queue for communications. 



Specifies that access to the queue is to be gained with 
the GET and PUT macro-instructions. 
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Table 3. Message Log DCB Macro- Instruction Keyword Parameters 



Keyword 
Parameters 



T T 

Alternate 
Source 
Code 
+- 



Parameter Description 



DDNAME=name 



Specifies the name that appears in the DD statement 
associated with the data control block. 



DSORG=PS 



PS 



Specifies a sequential data set organization. 



MACRF=(PM) 



(PM) 



Specifies the use of the PUT macro-instruction with the 
move mode. 



fRECFM=V 1 
\RECFM=VB / 



C,D 



VB 



Specifies variable length records. 
Specifies variable length blocked records. 



BLKSIZE=n 



C,D 



Specifies the maximum physical block length. It should be 
greater than or equal to the maximum segment length. 



BFTEK=SMP 



C r D 



SMP 



indicates simple buffering. 



BUFNO=n 



Specifies the number of buffers to be obtained by QSAM at 

open time, where n<255. The parameter n should be 

specified greater than or equal to two. If it is 

specified as one, the message control task may have to 
wait for the buffer. 

Note : For additional information concerning the specification 
of this DCB macro-instruction, refer to "Queued Sequential 
Access Method (QSAM) " in the publication IBM Operating 
System/360: Control Program Services . 



BUFL=n 



Specifies the length in bytes of the buffers to be 
obtained by QSAM at open time, where n<32,767. The 
parameter should be greater than or equal to the maximum 
segment length. 



DEVD=DA 
DEVD=DT 
DEVD=TA 
DEVD=PC 
DEVD=PR 



DA 

DT 
TA 
PC 
PR 



-+- 



Specifies that the logging device is a direct-access 
device. 

Specifies that the logging device is a paper tape. 

Specifies that the logging device is a magnetic tape. 

Specifies that the logging device is a card punch. 

Specifies that the logging device is a printer. 



[DEN=0 
< DEN=1 
lDEN=2 



C,E 




1 
2 

Note: 



Specifies that the tape density is low. 
Specifies that the tape density is medium. 
Specifies that the tape density is high. 

This parameter is required only for tape devices. If it 



is not specified, high density is assumed. 
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Table 4. Message Processing Task Input DCB Macro-Instruction Keyword Parameters 



T T 

Alternate 
Source 
Code 
+- 



Keyword 
Parameters 



Parameter Description 



DDNAME=name 



name 



Specifies the 
associated with 
the name used 
process queue. 



name that appears in the DD statement 

the data control block. This name is also 

in the terminal table to identify the 



DSORG=MQ 



MQ 



Identifies th 
processing prog 



e data set organization as that of a 
ram message queue for telecommunications. 



MACRF=G 



Specifies that 
the GET macro-i 



access to the queue is to be gained with 
nstruction. 



BUFRQ=n 



C, E 



Specifies the 
(from GET macro 



number of buffers to be read in advance 
-instruction), where n<255. 



Note : BUFRQ=0 will be assumed if a value is not provided 



+- 



through the DCB macro-instruction or an alternate source. 



SOWA=n 



I-T-- 



C,E 



=T-+ 



Specifies the size in bytes of the user-provided input 
workarea, where n<32,767. If this parameter is not 
provided through the DCB macro-instruction or an alternate 
source, the jcb will be terminated. 



(RECFM=G 
< RECFM=S 

Irecfm=r 



C,E 



end-of -transmission 



G, S, or R 

Specifies the work unit as tollows: 
G - message (defined by the 

character) . 
S - segment (defined by the buffer size). 

R - record (defined by the carriage return, line feed, 
combined carriage return-line feed, or end-of-block 
character) . 



Note: RECFM=S will be assumed if no value is provided 
the DCB macro-instruction or an alternate source. 



tnrough 



+- 



EODAD=addr 



addr 



Specifies the symbolic address of a user-provided routine 
to be entered if no messages are available when a GET 
macro-instruction is issued. If no value is provided 
through the DCB macro-instruction or an alternate source, 
a WAIT macro-instruction will be implied. 



TRMAD=addr 



addr 



Specifies the symbolic address of a user-provided area to 
contain the terminal name. When a GET macro-instruction 
is issued, the source terminal name will be placed at the 
specified address by QTAM. If the parameter is not 
provided through the DCB macro-instruction or an alternate 
source, the jcb will be terminated. 



SYNAD=addr 



addr 



Specifies the symbolic address of a user-provided routine 
to be entered if a work unit is longer than the workarea 
provided for input. If the parameter is not provided 
through the DCB macro-instruction or an alternate source, 
the remainder of the work unit will be supplied when the 
next GET macro- instruction is issued. 
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Table 5. Message Processing Task Output DCB Macro-Instruction Keyword Parameters 

r t t 



Keyword 
Parameters 


| Alternate | 
j Source j 
| Code j Parameter Description 

-4- 4- — — 


DDNAME=nam€ 


T T 

2 | j name 

j | Specifies the name that appears in the DD statement 
j j associated with the data control block. (Refer to the 
| | publication IBM System/360 Operating System: Job Control 


I | Language.) 


_ — T T 

DSORG=MQ | | MQ 

| | Identifies the data set organization as that of a process- 
j | ing program message queue for telecommunications. 

J. _ L _ 


T — r 

MACRF=P | | P 

| | Specifies that the queue is to be referred to by the PUT 
j J macro- instruction. 

4- — X — — 


T T 

SOWA=n | C, E | n 

j | Specifies the size in bytes of the user-provided output 
j j workarea, where n<32,767. If this parameter is not 
j j provided through the DCB macro-instruction or an alternate 
j j source, the jcb will be terminated. 

_ J- x 


(recfm=gY 

< RECFM=S \ 

Vrecfm=rJ 


T T 

|C, E |G, S, or R 

j j Specifies the work unit as follows: 

j j G - message (defined by the end-of -transmission 
j | character) . 

j | S - segment (defined by the buffer size). 

j j R - record (defined by the carriage return, line feed, 
j j combined carriage return-line feed, or end-of- block 
j | character) . 

| INote: RECFM=S will be assumed if no value is provided throuqh 




| |the DCB macro-instruction or an alternate source. 
.4.-4- 


TRMAD=addr 


"1 " T "" " "~ """ " "" 

| E | addr 

j | Specifies the symbolic address of a user-provided area to 
j | contain the terminal table entry name. If the parameter 
j j is not provided before the data set is opened, the job 
j j will be terminated. When a PUT macro-instruction is 
j | issued, the destination terminal name must be provided at 
j j the specified address by the user. The name must be 
j j defined in a terminal table entry within the message 
| j control task. (Refer to the TERM, LIST, and PROCESS 
j | macro-instructions described under "Terminal Table Speci- 
j | fications.") 



L J. J. J 
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Examples ; The DCB macro-instruction that 
defines the parameters of a data control 
fclock associated with a communications line 
group (Table 1) could be: 



Name 



- T T 

| Operation | Operand 



I. + + .j 

GROUPONE I DCE | DDNAME=DDGROUPl, 

|DSORG=CX, 
|CPOLL=(POLLINEl, 
| P0LLINE2) , 
j MACRF= ( G , P) , BUFRQ=3 , 
|CPRI=E,ACLOC=25, 
| CLPS=LPS1 
L J. x J 



| Name 




t r 

Operation | Operand 



DCB |DDNAME=PRCIN, 
|DSORG=MQ, 
1 MACRF=G , 

|BUFRQ=2,SOWA=300, 
|RECFM=G, 
|TRMAD=SOURCE, 
I SYNAD= ERROR 



The DCB macro-instruction that defines 
the parameters of a data control block 
associated with an output message process- 
ing queue (Table 5) could be: 



The DCB macro-instruction that defines 
the parameters of a data control block 
associated with a direct-access storage 
device to be used for message queueing 
(Table 2) could be: 




t t 

Operation | Operand 



| DDNAME=PRCOUT , 

|DSORG=MQ, 

|MACRF=P,SOWA=300, 

JRECFM-G, 

I TRMAD=DESTN 



r t t 1 

I Name | Operation | Operand | 

y + + j 

j QUEUE | DCB j DDNAME=DDFILE, | 
I | |DSORG=CQ, | 

| | |MACRF=(G,P) | 

L J. X J 



The DCB macro-instruction that defines 
the parameters of a data control block 
associated with a message logging device 
(Table 3) could be: 



Name 



T T 

Operation | Operand 




|DDNAME=DDLOG, 

| DSORG=PS, 

I MACRF= ( PM) , RECFM=V, 

|BLKSIZE=100, 

|BFTEK=SMP, 

|BUFNO=3,BUFL=100, 

|DEVD=TA,DEN=1 



OPEN AND CLOSE MACRO- INSTRUCTIONS 



To initialize a data set (make it acces- 
sible by a problem program) , an OPEN macro- 
instruction that specifies the data control 
block associated with the data set must be 
issued. In certain cases, the OPEN macro- 
instruction must also specify whether the 
data set is being opened for input or 
output. When the OPEN macro-instruction is 
issued, the following general functions 
will be performed: 

• Completion of the initialization of the 
data control block. 

• Acquisition of the access method 
subroutines. 

• Acquisition of main storage for inter- 
nal control blocks required by the 
access method. 

To terminate use of a data set, the 

CLOSE macro- instruction is issued. The 

following general functions will be per- 
formed : 



The DCB macro- instruction that defines 
the parameters of a data control block 
associated with an input message processing 
queue (Table 4) could be: 



• Releasing main storage acquired at open 
time. 

• Releasing subroutines acquired at open 
time. 

• Clearing the data control block fields 
which were initialized at open time. 
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OPEN Macro- Instruction 



The OPEN macro- instruction makes the 
following ready for use: queues on direct- 
access storage devices, data sets on 
logging devices, processing queues, and 
communications line groups. Each of these 
data sets must be opened before any ref- 
erence can be made to it. This macro- 
instruction, when used, has the following 
effects : 



If a communications line group data 
control block is specified, the OPEN 
macro- instruction causes all lines in 
the group to be prepared for operation. 
The actual activation of the lines for 
message transmission occurs 
automatically unless IDLE is specified 
as the second entry in the sublist in 
the OPEN macro-instruction for the com- 
munications line group DCB. If the 
line group is specified as an input, or 
input and output line group, and the 
IDLE operand is not included, the OPEN 
macro-instruction initiates polling on 
those lines in the line group that have 
an active polling list with terminal 
entries. (A polling list is specified 
by the POLL macro-instruction; terminal 
entries may or may not be included. An 
active polling list is one in which the 
second byte of the list is a non-zero 
character.) If IDLE is specified, all 
of the lines or particular lines in the 
line group can be subsequently activa- 
ted by one or more STRTLN macro- 
instructions; however, STRTLN must not 
be included in the Line Procedure 
Specification section of the message 
control task macro-instructions. The 
user can also inhibit polling on a line 
by changing the second byte of the 
polling list for that line to zero 
before issuing the OPEN (see "Change 
Polling List (CHNGPL) Macro- Instruc- 
tion") . Lines used for output only 
(see below) are never polled. 
If a direct-access queue data control 
block is specified, and it is specified 
that there are messages from a previous 
period in the queues, it will update 
queue status tables to enable these 
messages to be transmitted. 
If a process data control block is 
specified, it causes QTAM to be pre- 
pared to deliver messages to or receive 
messages from the message processing 
task, depending upon whether input or 
output is specified. 

If a logging data control block is 
specified, it causes the QSAM routines 
to be entered into the system and be 
prepared for placing messages on a 
logging device. Output must be speci- 
fied. 



Name 



"T T 

I Operation | Operand 



y + 1 H 



[symbol] JOPEN 



(dcbnamei , 



[INPUT ^ 
(< OUTPUT > 

Unout J 



[,IDLE]) 

, . . . ,dcbname n , 

(INPUT "^ 
(< OUTPUT >[, IDLE ]) 

Unout J 

^i'MF=L \ 

\MF= (E, listname)/ 

L J. LZ -T J 

symbol 

Specifies the name for the OPEN macro- 
instruction. 

dcbname!. . .dcbname n 

Indicates the address of the data 
control block associated with the 
communications line group, direct- 
access queues, processing queue, or 
message log to be opened. The group 
of operands that can be repeated 
begins with dcbname and ends with 
IDLE. 

INPUT 

Indicates an input data set. If 
neither INPUT, OUTPUT, nor INOUT is 
specified, the operating system 
assumes that INPUT is specified. If: 
1) a communications line group is 
opened; 2) the INPUT operand is speci- 
fied or no operand is included in its 
place; and 3) the IDLE operand is 
omitted, polling begins on all lines 
with an active polling list and termi- 
nal entries on that list. 

OUTPUT 

Indicates an output data set. If a 
communications line group is opened, 
and this operand is specified, the 
CPOLL keyword operand sublist of the 
DCB macro-instruction for the line 
group must point to a polling list 
with no terminal entries. 



INOUT 



Indicates a data set that can be used 
for input and output. If a communi- 
cations line group is opened, and this 
operand is specified, some of - the 
lines can be used for input and others 
for output. If an entry in the sub- 
list of the CPOLL keyword parameter in 
the DCB macro-instruction for the line 
group points to a polling list with 
terminal entries, the line is a polled 
input line; polling begins if the 
polling list is active and the IDLE 
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operand is not specified in the OPEN 
macro- instruction for the line group. 
If an entry in the sublist of the 
CPOLL keyword parameter of the line 
group DCB points to a polling list 
with no terminal entries, the line is 
an output line. 

Note: If neither INPUT, OUTPUT, nor INOUT 
is indicated for a data set, and another 
data control block address is specified, 
two commas must appear between the two data 
control block addresses. 



I DIE 



Pertains only to communications line 
groups. If a communications line 
group is opened, and the IDLE operand 
is included, the data set for the line 
group is initialized but the lines 
remain inactive until activated by a 
STRTLN macro- instruction. If the IDLE 
operand is omitted, all lines in the 
group are automatically activated as 
part of the OPEN instruction's func- 
tions. If the IDLE operand is includ- 
ed, and neither INPUT, OUTPUT, nor 
INOUT is specified, a comma must be 
placed before IDLE to represent the 
missing preceding operand in the sub- 
list. 



be executed with all the specified paramet- 
ers. The advantage of the use of MF=L and 
MF=(E, listname) operands is that one param- 
eter list (created through MF=L) can serve 
several OPEN and CLOSE macro-instructions 
with the MF=(E, listname) operand. For 
example, an OPEN macro-instruction with the 
tfF=L operand creates a parameter list; 
several CLOSE macro-instructions, each with 
the MF=(E, listname) operand and each to be 
executed depending on a given situation, 
can subsequently reference the list. If 
these keyword operands are not used, one 
parameter list is generated in-line each 
time an OPEN or CLOSE macro-instruction for 
the line group is specified. 

Note ; Data sets transmitted over communi- 
cations lines and data sets on direct- 
access storage devices for queueing and on 
logging devices must be opened in the 
message control task. Data sets on message 
processing task queues must be opened in 
the user's message processing task. Data 
sets on direct-access devices must be 
opened before any other data sets used in 
QTAM. 

Examples ; An OPEN macro-instruction that 
could be used in the message control task 
is: 



Note: If neither the input/output designa- 
tion nor the IDLE operand is included for a 
data set, and another data control block 
address is specified, two commas must 
appear between the two specified data con- 
trol block addresses. 



r t t 1 

| Name | Operation | Operand | 

j. + 1 -I 

| | OPEN | (QUEUE,, GROUPONE, (, IDLE) , | 
| | | MSGLOG, (OUTPUT)) j 

L J. J. J 



WF=L 

Causes the creation of a parameter 
list based on the entries specified in 
the operand section of the OPEN macro- 
instruction. No executable code is 
generated. The functions specified by 
the preceding parameters are not 
performed until the problem program 
encounters an OPEN macro-instruction 
with a keyword parameter referencing 
the parameter list (see below) . The 
name assigned to the parameter list is 
specified in the name field of the 
OPEN macro- instruction containing the 
MF=L operand. 

MF=(E, listname) 

Causes the execution of those func- 
tions indicated by the parameter list 
named "listname." This list was pre- 
viously created by an OPEN macro- 
instruction with the MF=L keyword 
parameter. Parameters included in the 
OPEN instruction with the 
MF= (E, listname) entry override corres- 
ponding entries in the parameter list. 

Note: The absence of the MF keyword param- 
eter causes the OPEN macro- instruction to 



An OPEN macro-instruction that could be 
used in the message processing task is: 

r t t 1 

| Name | Operation | Operand | 

h 1 + 1 

| | OPEN j (PPMQIN, (INPUT) , PPMQOUT, j 
| | | (OUTPUT)) ,MF=(E,OPENNAME) | 

L J. L J 

Note: Refer to examples of the DCB macro- 
instruction. 



CLOSE Macro-Instruction 



The CLOSE macro-instruction removes 
direct-access storage queues, processing 
queues, and communications line groups from 
active use; i.e., closes them. When not 
required for further operations, these 
queues and line groups should be closed in 
order to release core storage, clear output 
areas, and relinquish volumes (where 
applicable) . This macro-instruction, when 
used to close a communications line group, 
has the following effects: 
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Operations on all lines in the group are 
stopped. If a line was conditioned by a 
CHNGPL macro- instruction to stop receiving, 
all messages queued for transmission on the 
line will be transmitted before control is 
returned to the program issuing the CLOSE 
macro-instruction. If the line was not 
conditioned to stop receiving, control is 
returned to the program issuing the CLOSE 
macro-instruction immediately after the 
completion of any message being transmit- 
ted. In the latter case, any messages 
remaining in the queue for a line will be 
transmitted when the data control block for 
the communications line group is reopened. 

To close one line within a communi- 
cations line group, the STOPLN macro- 
instruction should be used (see "Stop Line 
(STOPLN) Macro-Instruction" under "Message 
Processing Task"). 



Name 



-t t 

| Operat ion | Operand 



|. x x 

[symbol] | CLOSE | (dcbname lf , . . . 

dcbname n ) 

",/MF=L V 
\MF=(E, listname)/ 
l x r xl t J 



symbol 

Specifies the name 
macro- instruction. 



for the 



CLOSE 



dcbname lf , . . . dcbname n 

Indicates the address of the data 
control block associated with the 
direct-access queue, the processing 
queue, or the communications line 
group to be closed. 



viously created by a CLOSE macro- 
instruction with the MF=L keyword 
parameter. Parameters included in the 
CLOSE instruction with the 
MF=(E,listname) entry override corres- 
ponding entries in the parameter list. 
(Information contained in the note 
under "OPEN Macro-Instruction" also 
pertains to CLOSE.) 

RESTRICTION; A direct-access queue data 
control block must not be closed while any 
line group or process data control block is 
open. 

Note: Data sets associated with communi- 
cations lines and data sets on direct- 
access storage devices for queueing and on 
logging devices must be closed in the 
message control task. Data sets on 
processing program message queues must be 
closed 
task. 



in the user's message processing 



Two additional forms of the CLOSE macro- 
instruction are available: the E form and 
the L form. (For a description of the use 
of these forms, refer to the publication 
IBM System/360 Operating System: Control 
Program Services . ) 

Examples: The CLOSE macro-instruction that 
is used in the message control task could 
be: 



r t 1 

| Operation | Operand | 

|. x 4 

JCLOSE j (GROUPONE,, QUEUE, ,MSGLOG) | 
L. X . J 

The CLOSE macro-instruction that is used 
in the message processing task could be: 



Note: The two commas immediately following 
dcbname should be omitted if the operand is 
the last (or only) positional operand. 

MF=L 

Causes the creation of a parameter 
list based on the entries specified in 
the operand section of the CLOSE 
macro- instruction. No executable code 
is generated. The functions indicated 
by the preceding parameters are not 
performed until the problem program 
encounters a CLOSE macro- instruction 
with a keyword parameter referencing 
the parameter list (see below) . The 
name assigned to the parameter list is 
specified in the name field of the 
CLOSE macro-instruction containing the 
MF=L entry. 

MF=(E, listname) 

Causes the execution of those func- 
tions indicated by the parameter list 
named "listname". This list was pre- 



r t 1 

| Operation | Operand | 

h _ x H 

JCLOSE | (PPMQIN,,PPMQOUT) | 

L x J 

Note: Refer to examples of the DCB macro- 
instruction. 



MESSAGE CONTROL TASK 



The message control task includes both 
device handling and message handling 
routines of QTAM. Messages destined for 
other terminals (as in a message switching 
application) can be completely handled by 
the message control task. Messages that 
require processing by a user's program can 
be directed to or taken from the message 
processing task queues that are referred to 
by the user's message processing tasks. 
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Messages arriving from terminals are 
coded according to the transmission code of 
the particular terminal. The message con- 
trol task includes facilities that convert 
these transmission codes to the extended 
hinary-coded decimal interchange code 
(EBCDIC) which results in simplification of 
message analysis. In addition, the message 
control task can perform the following 
functions: 



Terminal polling. 

Time and date stamping of incoming 
messages. 

Sequence checking of incoming messages 
Logging of message traffic on a secon- 
dary storage device (disk, tape, or 
drum) . 

Checking validity of source terminal 
code. 

Routing of incoming messages to their 
destination (processing queue or 
terminal) . 



Messages received from terminals can be 
routed to one or more destinations. The 
routines check the validity of the destina- 
tion codes and place messages in queues 
according to their destinations. A priori- 
ty scheme may be included so that process- 
ing of certain messages can be expedited. 

Messages being sent to a terminal must 
be converted to the appropriate transmis- 
sion line code. The following functions 
are also provided for processing outgoing 
messages : 



Terminal addressing. 

Time and date stamping. 

Sequence numbering. 

Logging on secondary storage 

such as disks, tapes, or drums. 



To define the message control task, a 
user must specify appropriate system- 
supplied macro-instructions. The message 
control task must operate as a high- 
priority task. A message control task for 
Tele-processing operations need remain in 
main storage only as long as message 
processing is going on. 

There are two major categories of macro- 
instructions that may be selected for 
inclusion in the message control task: 
control information and line procedure 
specifications. Control information macro- 
instructions create tables, lists, and 
buffer areas needed in the system; line 
procedure specification macro-instructions 
provide for such functions as message head- 
er analysis, routing, and error handling. 



CONTROL INFORMATION 



To use the optional functions of QTAM, a 
user must provide certain control informa- 
tion. This data includes the following: 

• A terminal table that contains all of 
the valid terminal codes as well as 
complete information about the termi- 
nals connected to the system. 

• A polling list that provides the 
sequence in which terminals on a line 
an to be polled. 

• suffer specifications that provide the 
definition of message segment sizes, 
the type of buffering, and the maximum 
number of segments needed by QTAM. 



Terminal Table Specifications 



The terminal table consists of the 
lowing parts : 



fol- 



• A control field that defines the length 
of the terminal table. 

• Optional fields that contain informa- 
tion defined by the programmer. 

• Terminal descriptions that contain the 
terminal, the message processing queue, 
and the distribution list codes, as 
well as other pertinent control infor- 
mation. (All terminal table entry 
names must have the same number of 
characters. ) 

The macro-instructions presented below 
may be used to create the terminal table. 



devices Terminal Table (TERMTBL) Macro-Instruction 



The TERMTBL macro-instruction causes a 
control field to be created for the termi- 
nal table. It provides a definition of the 
length of the table. Only one such 
instruction is necessary for the table. 

r t t n 

| Name | Operation | Operand | 

j. + 1 -I 

j | TERMTBL | entry | 

L J. -L J 

entry 

Specifies the terminal name of the 
last entry in the terminal table. 

RESTRICTION: The TERMTBL macro-instruction 
must be the first of those specified to 
create the terminal table. 
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Note; TERMTBL is the symbolic address of 
the terminal table. 



Terminal Table Optional Field (OPTION) 
Macro- Instruction 



The OPTION macro- instruction is used to 
allocate storage for a specified subfield 
to be included in the user area of each 
terminal table entry created by the TERM 
macro-instruction. One OPTION macro- 
instruction is necessary for each required 
subfield. The order of these instructions 
defines the order of the subfields within 
the user area. A standard definition of 
this area is provided to permit symbolic 
references to each subfield. 

r t t T 

I Name | Operation | Operand | 

h x x H 

| symbolic | OPTION | subfield type | 
j name of j | and length | 

| subfield | | | 

l j. x j 



or a group of terminals. One TERM macro- 
instruction is required for each terminal 
that can transmit a message and each 
terminal or group of terminals that can 
receive a message. 



r t t 

| Name | Operation | Operand 

j. x x 

| entry j TERM j | T^ 

| j |\LJ,dcbname, rln, 

j j j addressing, [ (optdata ± , 

j | j . . . ,optdata n ) ] 

i l x 



entry 



Represents the symbolic terminal name. 
It can have from one to eight nonblank 
characters, however, all terminal 
names in the system must have the same 
length. 



Indicates that outgoing messages are 
to be queued by terminals. Highest 
priority terminal messages are sent 
first. 



symbolic name of subfield 

Refers to a specific subfield. It can 
have a maximum of eight characters. 

subfield type and length 

Specifies the standard assembler 
language format; e.g., XL3 or CL8, 
etc. 

RESTRICTION; The required OPTION macro- 
instruction must immediately follow the 
TERMTBL macro-instruction and be in the 
same order as the optdata field of the TERM 
macro- instruction. For example: 



I Name 



h 



■T T 

| Operation | Operand 



| | TERMTBL 
| TRAFFIC | OPTION 
| STATl 1 OPTION 
JALTNTERM j OPTION 
IPOLLIMIT | OPTION 

L X . 


|KCHI 
|XL4 
|XL1 
|AL3 
|XL1 
_x 


Note: The actual 


data 



values to be 
inserted into each user optional field are 
specified in each TERM macro-instruction. 



Terminal Table Entry (TERM) 
Macro- Instruction 



The TERM macro- instruction causes a ter- 
minal name and its parameters to be includ- 
ed as an entry of the terminal table. The 
terminal name represents a single terminal 



Indicates that outgoing messages are 
to be queued by communications lines. 
Messages for all terminals on the line 
are sent on a first-in-first-out 
basis. When this option is used, all 
terminals associated with a line must 
use the same option. 

dcbname 

Indicates the symbolic name of the 
data control block for the communi- 
cations line group to which the termi- 
nal is attached. 

rln 

Specifies the relative line number 
within the line group to which the 
given terminal is attached. For a 
terminal on a dialing line, this num- 
ber should always be 1. 

addressing 

Represents the addressing and polling 
characters for the terminal (see Table 
6) . The characters must be specified 
in the hexadecimal equivalent of the 
particular device code. 

optdata^, . . . ,optdata n 

Represents the actual data to be 
inserted into the user area subfields 
of this entry. There must be an exact 
one-to-one correspondence between the 
data specified here and the specified 
type and length allocation made in the 
OPTION macro-instruction. 



Note: A comma is used to 
belonging to each subfield. 



separate data 
Character data 
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must be 
marks- 



delimited by single quotation 



Terminal Table List (LIST) 
Macro- Instruct ion 



RESTRICTION: Terminal names representing 
another distribution list may not be 
included as a list entry. All terminal 
names in the list must be defined by a TERM 
or PROCESS macro-instruction. 



The LIST macro- instruction causes a name 
and a list of terminals that it represents 
to be included as an entry in the terminal 
table. One LIST macro- instruction is need- 
ed for each distribution list to be sup- 
plied. 

r t t t 

| Name | Operation! Operand | 

j. + + j 

| entry | LIST ] (entry lw entry 2 r - • . , | 
I I I entry n ) | 
l x x . j 

entry 

Represents the symbolic name of the 
distribution list. It can have from 
one to eight characters, however, all 
terminal names in the system must be 
the same length. 

entry ± , entry 2 , - . . , entry n 

Indicates the symbolic terminal name 
to be included in the distribution 
list of this entry. 



Terminal Table Process (PROCESS) 
Macro- Instruction 



The PROCESS macro-instruction causes a 
name that represents a processing program 
message queue to be included as an entry in 
the terminal table. One PROCESS macro- 
instruction is needed for each process 
queue defined. 

r t t 1 

| Name | Opera ti on | Operand | 

h + + -i 

j entry j PROCESS | [EXPEDITE] | 

L X X J 



entry 



Represents the symbolic terminal name. 
It can have from one to eight 
characters, however, all terminal 
names of the system must be the same 
length. 



Table 6. Terminal Polling and Addressing Codes Format 



j Terminal Type 
I- 



Format 





IBM 1060 Data Communications System | |2 Addressing! 2 Polling | 
AT 6 T 83B2 Selective Calling Stations | j Characters | Characters! 
Western Union Plan 115A Outstations j L J- J 

_ _____ x — — — — 


_____ ^.__ _ _ 


| r _ _ T _ T _ , 

IBM 1050 Data Communications System | | Number of | Dial |2 Addressing! 

(dial service) j j Dial Digits j Digits j Characters j 

L X X _ _ J 

_ _ _ _ _ x — — 


_ _ — _ _ _ _ _^. — _ _ _ 

1 r T T T 1 
Common Carrier TWX Stations | | Number of |Dial | Number of | Identi- | 

j JDial Digits | Digits j Identifica-jficationj 
j | j jtion Digitsj | 

|L_ _X X X J 

__ ____x — — 


__ ___ _.|. _ 


1 r - i 
IBM 1030 Data Collection System | |2 Addressing! 

j | Characters j 

L _ _J 



U X J 
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EXPEDITE 

When provided, indicates that message 
segments will be routed directly to 
the processing program. The EXPEDITE 
option should not be used when multi- 
segment messages are expected. If 
queueing on a direct-access device is 
specified, the messages are not 
written on the device and the RETRIEVE 
macro- instruction may not be used. 
The data control block used to get 
messages from this queue must specify 
RECFM=S. (Refer to the "Data Control 
Block (DCB) Macro- Instruction. ") 

Example ; Table 7 is an example of the 
coding sequence that might be used to 
create the terminal table for use with a 
system. Instruction number 1 of Table 7 is 
the TERMTBL macro- instruction, which iden- 
tifies the last entry in the terminal 
table. 

Instruction number 2 defines a 1-byte 
field named LIMIT for each terminal iden- 
tified in the terminal table. This is the 
field which may be referred to in the 
POLLIMIT macro- instruction to limit the 
number of times a terminal is consecutively 
polled during each polling pass. 

Instructions number 3 through 7 cause 
five terminals and their respective param- 
eters to be recorded in the terminal table. 
In this example, outgoing messages are to 
be queued by communications lines. The 
first operand of each 
instruction, therefore, is 
queueing were by terminal, 
would be a T. 



TERM mac ro- 
an L. If 
this operand 



The second operand of each TERM macro- 
instruction indicates the symbolic name of 
the data control block for the line group 
to which the terminal is attached. In this 
case, there is one communications line 
group (hence one data control block) . 

The third operand is the relative line 
number. The terminals identified by the 



codes CHI and BOS are attached to one line, 
which has a relative line number of 1. The 
other three terminals (PHI, NYC, and WAS) 
are attached to another line, which has a 
relative line number of 2. The fourth 
operand of each TERM macro-instruction 
contains the addressing and polling codes 
(in hexadecimal) for the terminal. 



The fifth operand 
instruction contains 
limit to be inserted 
by the OPTION macro- 
and PHI can each be 
twice during each 
and WAS entries, h 
polled once during ea 



of each TERM macro- 
the actual polling 
in the field defined 
instruction. NYC, CHI 
consecutively polled 
polling pass. The BOS 
owever, can only be 
ch polling pass. 



Instruction number 8, the LIST macro- 
instruction, is used to create a 
distribution list within the terminal 
table. This macro-instruction causes a 
distribution list called PBW to be recorded 
in the terminal table. The terminals on 
the list are BOS and WAS. When PBW is 
listed in a message header as a destination 
code, messages will be routed to Boston and 
Washington. 

Instruction number 9 of Table 7 is a 
PROCESS macro-instruction. This instruc- 
tion defines a process queue called CPU. 
This queue will contain messages for a 
message processing program. 



Polling List Definition 



The order in which terminals are polled 
on a line is determined by the polling 
list. Terminal names may be entered in the 
list as often as desired and in any order. 
Since a polling list must not refer to 
terminals on more than one line a list must 
be defined for each line. 



The POLL macro-instruction can 
to create a polling list. 



be used 
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Table 7, 



Terminal Table Creation Format 



r t t t 

I No. I Name | Operation | Operand 
|. x x x 

TERMTBL I CPU 



Comments 



1 1 




1 2 


LIMIT | 


1 3 


CHI | 


1 4 


NYC | 


1 5 


PHI | 


1 6 


EOS | 


1 7 


WAS | 


1 8 


PBW | 


1 9 


CPU | 



OPTION 

TERM 
TERM 
TERM 
TERM 
TERM 
LIST 

PROCESS 



FL1 

L,DCBGROUP, 1,E407E40D, (2) 
L,DCBGROUP, 2 f E207E20D f (2) 
L, DCBGROUP, 2,E407E40D, (2) 
L,DCBGROUP,1,E207E20D, (1) 
L, DCBGROUP, 2, E707E70D, (1) 
(BOS, WAS) 



Identifies last entry in the terminal 
table. 

Specifies name and size of LIMIT field 
to be used with the POLLIMIT macro- 
instruction. 

Identifies terminals in the system as to 
type of queueing, name of the data 
control block for the communications 
line group, relative line number, 
address and polling characters (in 
hexadecimal) , and maximum number of 
consecutive polls. 



Defines a distribution list called PBW 
for terminals Boston and Washington. 

Defines process queue called CPU to 
receive messages routed to it. 



Polling Table Definition (POLL) 
Macro- Instruction 



The POLL macro- instruction defines the 
order in which the terminals on a line are 
to be polled. A given terminal can be 
specified any number of times in the list. 
One POLL macro-instruction must be included 
for each line in the system. If the line 
is used for output only, the operand field 
of this macro-instruction must be blank. 



t t 

Name | Operation! Operand 
x 



h 

J P0LLINE1 | POLL 
|. + 

j P0LLINE2 j POLL 
I X 



| (CHI, BOS) j 

_X -j 

| (NYC, PHI, NYC, WAS) j 
.X J 



Buffer Assignment 



r t t 1 

| Name | Operation | Operand | 

|. x x .j 

| pollname | POLL | (entry lr . . . ,entry n ) | 
l x x j 

pollname 

Represents the name of a line's poll- 
ing list. The name is also a paramet- 
er of the DCB macro-instruction for 
the communications line group. 

entry A , . . . , entry n 

Specifies the terminal table entry 
names in the order in which the termi- 
nals are to be polled for a given 
line. Each entry must be the name of 
a TERM macro- instruction that defines 
a single terminal. If the line is 
used for output only, the entry oper- 
ands must be omitted. 

Example: The POLL macro-instruction might 
te used in the following manner to define 
an order for polling terminals on each line 
of the sample system: 



The user must specify the amount of main 
storage to be used for input and output 
buffering. This buffer area will be a pool 
of buffers that are used on a dynamic basis 
for all communications lines, direct-access 
queueing devices, and processing queues. 

The following macro-instruction is pro- 
vided for specifying the buffer areas. 



BUFFER Macro- Instruction 



The BUFFER macro-instruction provides 
the main storage buffer areas for QTAM and 
specifies direct-access or main storage 
queueing. 

r t t 1 

| Name | Operation! Operand | 

h x x .j 

j | BUFFER | [dcbname],n, length j 
i x x J 
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dcbname 

Indicates the name of the data control 
block for the direct-access queues 
used for queueing of QTAM messages. 
If main storage queueing is used, this 
field is blank. 



Represents the number of buffers to be 
reserved. 

length 

Represents the length, in number of 
bytes, of each buffer. All buffers in 
the buffer pool will be of the same 
length and should be specified as a 
minimum size equal to or greater than 
a message header plus a message header 
prefix. Buffer length determines the 
message segment size used in the sys- 
tem. The maximum buffer size is 281 
bytes. 

Note; The entire header must be contained 
in the first segment of the message. Where 
applicable, the entire header must appear 
before the occurrence of the end-of-block 
(EOB) character. 

Example; The coding in the example below 
defines 60 buffers, each 125 characters 
long. Since the header prefix is 37 char- 
acters long, the header segment cannot 
exceed 88 characters (125-37 = 88). 



with an OPEN macro-instruction and ends 
with an ENDREADY macro-instruction. If the 
user is opening a communications line group 
and indicates, through the IDLE operand, 
that the entire line group will not be 
activated at this point, STRTLN macro- 
instructions for each of the particular 
lines to be activated can be included in 
this section. (The OPEN macro-instruction 
is described under "OPEN and CLOSE 
Macro- Instructions" ; the STRTLN macro- 
instruction is discussed under "Message 
Processing Tasks.") 



A single OPEN, group of OPENS, or group 
of OPEN and STRTLN macro-instructions must 
be followed by an ENDREADY macro- 
instruction. ENDREADY is essentially a 
wait-type instruction; the event is the 
procurement of the first message. Only one 
ENDREADY macro-instruction can be included, 
and it must be the last in the group of 
initialization instructions. 



r t 1 

| Operation | Operand | 

h + .J 

| ENDREADY j j 

L X J 



r t 1 

| Operat ion | Operand | 

j. 1 -I 

j BUFFER |DCENAME,60,125 j 

L _L J 



LINE PROCEDURE SPECIFICATIONS 



The actual contents of a buffer used by 
QTAM is dependent on which type of segments 
occupy the buffer. These are the header 
segments and the text segments. Figure 4 
illustrates the buffer formats for the 
header prefix and text prefix; the LPS 
places the header prefix at the beginning 
of the header segment of a message, and the 
text prefix at the beginning of each text 
segment. 

Figure 5 illustrates a simplified rep- 
resentation of header and text segments of 
three messages. The relationship of mes- 
sages in a queue, if line queueing is 
specified, is shown. If terminal queueing 
is specified, the key identifying message 
destination will always indicate the same 
terminal. 



DATA SET INITIALIZATION MACRO- INSTRUCTIONS 



The data set initialization section of 
coding for the message control task begins 



QTAM provides macro-instructions that 
may be selected to define the message- 
handling procedure for a given line group. 
A group of macro-instructions selected to 
accomplish this is called a line procedure 
specification (LPS). An LPS, which is 
composed of delimiter and functional type 
macro-instructions, will be required for 
each communications line group. When the 
messages and the terminals of several line 
groups have similar characteristics, 
however, more than one can use the same 
LPS. 

The user can specify the macro- 
instructions within a given LPS in any 
order that will fit the message header 
format. This enables the user to design 
his message format in any way that is 
convenient for his own application. A 
restriction, however, is that the entire 
header portion of the message must be in 
the first segment. (Refer to "BUFFER 
Macro-Instruction.") In the case of an IBM 
1050 Data Communications System, the entire 
header must appear before the occurrence of 
the first end-of-block character. 
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Header Prefix (in Bytes) 
12 3 4 



7 8 



9 10 



11 12 13 



Queueing Information 


Message Priority 
and Linkage 


Segment Size 


Source Key 


MSTATUS* 


Message Address on 
Direct-Access Device 



18 19 20 



21 22 



23 



24 25 26 



27 28 



29 30 



Next Segment Link 


Previous Header Link 


Next Message Link 


Stored 

Scan 

Pointer 


Destination Key 


Message 
Sequence 
Number (In) 


Message 
Sequence 
Number (Out) 



Text Prefix (in Bytes) 
1 2 



3 4 



7 8 



9 10 



11 12 13 



Queueing Information 


Message Priority 
and Linkage 


Segment Size 


Source Key 


MSTATUS* 


Message Address on 
Direct-Access Device 



18 19 



20 



Next Segment Link 


Message Header Link 



'Significance of the bits within the MSTATUS byte is as follows: 

Bit 

CANCEL Jo = chain message 
I 1 =do not chain 

Bit 1 

REROUTE J = or '9' na ' co Py °f message header 
] 1 =duplicate copy of message header 

Bit 2 (unused) 

Bit 3 



SRVCD 



0: 



message not previously serviced (for output message) 
message previously serviced (for output message) 



Bit 4 



TR11NC -i = message complete 

J 1 =message incomplete 

Bit 5 

PRIORITY -< 0=message with no priority 

J 1 =message is sent with priority 



Bits 6-7 



SEGTYP •< 



00 = header 

01 =text 

10 = header(EOM) 
ll=text (EOM) 



L . -■ J 

Figure 4. Message Buffer Formats 
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Header and Text Segments 

(Except for Last 

Segment of Message) 

f K V 



Header Segments 
K 



Address of Next 
Segment of Message 



Address of Header 
of Next Message 



Address of 
Previous Message 



Key Identifying 
Message Identification 






I 

, 1 



J 







r 






1 


f 








B 


D 




Terminal 1 


Message Header 


Text 












f 


: irst (Header) 5egment of a Three-Segment Message 
























— 


C 


Text 










Second (Text) Segment 












— 




Text 






Last (Text) Segment 








| 










E 


A 


Terminal 2 


Message Header 


Text 


















f 


irst (Header) Segment of a One-Segment Message 


















1 






— 


F 


G 


D 


Terminal 2 


Message Header 


Text 








F 


irst (Header) Segment of a Two-Segment Message 
















L- 




Text 



| Last (Text) Segment 

L J 

Figure 5. Header and Text Segment Relationships in a Queue 



Delimiter macro-instructions are used to 
logically group the functional macro- 
instructions. They supply transfer 
instructions that allow the flow of opera- 
tion to bypass those functional macro- 
instructions which do not apply to the 
given message segment type (header or text) 
or message direction (receiving or 
sending) . 

Functional macro- instructions are those 
instructions that are selected to satisfy 
the specific handling requirements of mes- 
sages directed to the LPS. If a function 
is needed and is not supplied, the user may 
supply his own routines. 



DELIMITER MACRO- INSTRUCTIONS 



Delimiter macro- instructions can be used 
to identify the type of message segments 



upon which a group of functional macro- 
instructions operates. For example, if a 
group of instructions is intended to 
operate only on header segments, that group 
of instructions must be preceded by a 
delimiter macro-instruction which permits 
operation only on the header segment. 



Table 8 presents an example of the 
typical order of delimiter macro- 
instructions within an LPS. The discussion 
which follows Table 8 presents the 
delimiter macro-instructions in the order 
presented in the table. Where functional 
macro-instructions may not be required, 
delimiter macro-instructions are indicated 
in the discussion as optional. Mandatory 
delimiters indicate the minimum functions 
required in the LPS. 
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Table 8. Line Procedure Specification Delimiter Macro-Instructions Order Format 



Delimiter 

Macro- Instructions 



Comments 



LPSTART 



Starting point of the LPS. 



RCVSEG 



Functional macro-instructions that operate on all segments of an 
input message. For example, the TRANS macro-instruction could be 
used here. 



RCVHDR 



I- 

ENDRCVE 



Functional macro-instructions that operate only on the header 
segment of an input message. For example, the macro-instructions 
that check on source and destination are used here. 



Functional macro-instructions that do message error handling. 



POSTRCVE 



End of input section. 



SENDHDR 



Functional macro-instructions that operate on the header segment 
of an output message. For example, the SEQOUT -macro-instruction 
could be used here. 



SENDSEG 



Functional macro-instructions that operate on all segments of an 
output message. For example, logging and the translating of the mes- 
sage to the terminal code could be done here. 



4- 



ENDSEND 



Functional macro-instructions that do message error handling. 



POSTSEND 



End of output section. 



Line Procedure Specification Start 
(LPSTART) Macro- Instruction 



The LPSTART macro-instruction is a deli- 
miter that provides an initialization pro- 
cedure for the LPS. It must be included as 
the first instruction of the LPS. 



Indicates the number of blank 
characters required for use by the 
TIMESTMP, DATESTMP, and SEQOUT macro- 
instructions. If this operand is 
blank, no space is reserved. 



r t t 1 

| Name | Operation! Operand | 

|. + + -I 

| label | LPSTART I [n] | 

L J. X J 

label 

Specifies the symbolic name to be 
assigned to the LPS. This operand 
name is the parameter addr specified 
in the CLPS=addr of the DCB macro- 
instruction for the line group. 



Receive Segment (RCVSEG) Macro-Instruction 



The RCVSEG macro-instruction is a 
delimiter that identifies the beginning of 
a program sequence that processes both 
header and text segments of incoming mes- 
sages. 
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r t t 

| Operation | Operand | 

j. + _I H 

| RCVSEG | | 

L J. J 



r T 1 

| Operation | Operand | 

j. + H 

|POSTRCVE | j 

L J. J 



Send Header (SENDHDR) Macro- Instruction 



Receive Header (RCVHCR) Macro-Instruction 



The RCVHDR macro- instruction is a delim- 
iter that identifies the beginning of a 
program sequence to process the header 
segment of incoming messages. 

r t 1 

| Operation] Operand | 

|. + .j 

| RCVHDR | | 

L X J 



The SENDHDR macro-instruction is a deli- 
miter that identifies the beginning of a 
program sequence to process the header 
segment of an outgoing message. When this 
service is not required, this delimiter is 
not required. 

r t t 

| Operation | Operand | 

h 1 -I 

j SENDHDR | | 

I J. J 



End Receive (ENDRCVE) Macro- Instruction 



The ENDRCVE macro-instruction is a 
delimiter that identifies the beginning of 
a program sequence to process end condi- 
tions for incoming messages. 

r t 1 

| Operation! Operand | 

j. + H 

| ENDRCVE | | 

L J. J 



Send Segment (SENDSEG) Macro-Instruction 



The SENDSEG macro-instruction is a deli- 
miter that identifies the beginning of a 
program sequence to process both header and 
text segments of outgoing messages. 

r t 1 

| Operation | Operand | 

I- + H 

| SENDSEG | | 

L L_- J 



The functional macro-instructions 
between the ENDRCVE and POSTRCVE macro- 
instructions are user-selected to test for 
errors and to control polling if necessary. 
When such instructions are not selected, 
this delimiter is not required. 

With an IBM 1050 Data Communications 
System, the user can choose to continue 
receiving a message after an end-of-block 
character causes a transmission 
interruption. When required, the user can 
also provide line correction procedures. 
(Refer to " En d-of- Block and Line Correction 
(EOBLC) Macro- Instruction.") 



Post Receive (POSTRCVE) Macro- Instruction 



The POSTRCVE macro-instruction is a 
delimiter that identifies the end of a 
program sequence to process incoming mes- 
sages. This delimiter is always required 
in an LPS. 



End Send (ENDSEND) Macro-Instruction 



The ENDSEND macro-instruction is a deli- 
miter that identifies the beginning of a 
program sequence to process end conditions 
for outgoing messages. 

r t 1 

| Operation | Operand | 

j. + H 

| ENDSEND | | 

L ± J 

The functional macro-instructions 
between the ENDSEND and POSTSEND macro- 
instructions are selected by the user for 
error testing and (if needed) error 
procedures. When such instructions are not 
selected, this delimiter is not required. 

With an IBM 1050 Data Communications 
System, the user can choose to continue 
sending a message after an end-of-block 
character causes a transmission interrup- 
tion. (Refer to "End-of -Block (EOB) Macro- 
Instruction. " ) 
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Post Send (POSTSEND) Macro- Instruction 



The POSTSEND macro-instruction is a 
delimiter that identifies the end of a 
program sequence to process outgoing mes- 
sages. This delimiter is always required 
in an LPS. 

r t 1 

| Operation | Operand | 

j. + ^ 

| POSTSEND | | 

L X J 



under the receive delimiters - 

• Receive or send, which indicates those 
macro-instructions that can be placed 
under either the receive or the send 
delimiters. 

• Send, which indicates those macro- 
instructions that can be placed only 
under the send delimiters. 

• Error handling, which indicates those 
macro-instructions that can be used to 
handle given error conditions. 

Note: For additional information on where 
each macro-instruction can be used and 
restrictions that might affect their use, 
refer to "Summary Charts." 



FUNCTIONAL MACRO- INSTRUCTIONS 



Functional macro-instructions can be 
used to process message header information. 
They use a QTAM subroutine to scan the 
message header and move the characters of 
header fields into a workarea. Since 
header scanning is always left to right, 
the functional macro-instructions must 
appear in the LPS in an order corresponding 
to the order of the header fields they 
service. 

A scan pointer used to locate each 
successive header character is maintained 
in a general register and is incremented as 
the header fields are scanned. When the 
LPS is entered to process a message being 
received or sent, the scan pointer is 
automatically initialized. 

If the user desires to eliminate the 
need for header field delimiters within the 
message header, the user must specify the 
length of each header field serviced by a 
functional macro-instruction. When lengths 
of header fields are specified, the scanner 
ignores blank characters erroneously embed- 
ded within a valid field. 

If it is desired to include variable 
length fields in the message header (for 
example, when omission of leading zeros is 
desired in fields that contain numeric 
data), the end of the field must be defined 
with a field delimiter. If the length of a 
field is not specified, it is handled as a 
variable length field. The scanner treats 
a blank character erroneously embedded 
within a variable length field as a field 
delimiter. 



RECEIVE FUNCTIONAL MACRO-INSTRUCTIONS 



Sequence In (SEQIN) Macro-Instruction 



The SEQIN macro-instruction checks the 
sequence number of each message from the 
same terminal as the message arrives in the 
system. If the sequence number is 
incorrect, an error flag is set in the 
error half-word. If the terminals are 
non-polled devices (e.g., dial devices), 
the SEQIN macro-instruction, if used, must 
be preceded by a SOURCE macro-instruction. 

r t 1 

| Operation | Operand | 

h + ., 

j SEQIN j [n] j 

L J. J 

n 

Specifies the number of characters in 
the header sequence number field. The 
maximum value of n is four. If this 
parameter is not specified a variable 
length field is assumed. Variable 
length fields must be followed by a 
blank character used as a field delim- 
iter. 

Note: The sequence number of the first 
message from a terminal must be 1. The 
maximum number is 9999. 



SOURCE Macro-Instruction 



Functional macro-instructions are divid- 
ed into the following four groups to aid 
the user in placing them under the correct 
delimiters: 

• Receive, which indicates those macro- 
instructions that can be placed only 



The SOURCE macro- instruction checks the 
validity of the contents of the source 
terminal code field received in the message 
header. If an invalid source terminal code 
is detected, an error is indicated in the 
error half-word for the line. 
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r t 1 

| Operation | Operand | 

j. 1 ^ 

| SOURCE | n | 

L J. J 



n 



Indicates the (decimal) number of 
characters in the source terminal code 
field of the message header. The 
maximum value of n is eight. 



Any combination of terminal codes may be 
used in a header destination field to route 
a message. 

RESTRICTION; Only one ROUTE macro- 
instruction can be specified for a message 
type. If the DIRECT macro-instruction is 
used for the message, the ROUTE macro- 
instruction cannot be used. 



End-of-Address (EOA) Macro-Instruction 



Routing (ROUTE) Macro-Instruction 



The ROUTE macro-instruction causes a 
validity check of the destination code 
field in the message header. If the desti- 
nation code is valid, the ROUTE macro- 
instruction causes the message to be queued 
for the specified destination. If an 
invalid destination code is detected in the 
header field, an error is indicated in the 
error half-word. This macro-instruction, 
used in conjunction with the EOA macro- 
instruction, permits multiple routing. 

r t 1 

| Operation | Operand | 

j. + .j 

j ROUTE j n J 

L JL J 



The EOA macro-instruction must 
immediately follow the ROUTE macro- 
instruction when multiple routing can be 
expected. This macro-instruction 
determines if any additional terminals are 
to receive the message. 

r t t 

| Operation | Operand | 

h + H 

| EOA j C ' char ' | 

L J. J 



char 



Indicates the EOA character that must 
appear in the message header after the 
last destination code. 



n 

Specifies the number of characters in 
the destination code field. The 
maximum value of n is eight. 

The terminal table that includes all 
valid destination terminal codes must 
be provided. (Refer to "Control Informa- 
tion.") 

A message can be directed to multiple 
destinations by including more than one 
terminal code in the destination code 
field. It is not necessary to state the 
number of destination codes in the message. 
An end-of-address character, as described 
under "End-of-Address (EOA) Macro- 
Instruction," is used to define the end of 
the destination field. 

Multiple destinations can also be 
specified by using a single terminal code 
to identify a distribution list in the 
terminal table. Each terminal in the dis- 
tribution list receives the message. 

Where special hardware features are 
available, "group code" transmission is 
another multiple addressing method that can 
be used. By using unique address charac- 
ters, a single message can be sent simulta- 
neously to a prespecified group of termi- 
nals on the same line. 



DIRECT Macro-Instruction 



The DIRECT macro-instruction causes a 
message to be queued for the destination 
specified in the operand. This macro- 
instruction may be used in place of the 
ROUTE macro-instruction when there is no 
destination data in the message header. 

r t 1 

| Operation | Operand | 

y + ., 

| DIRECT |/=c'dest , l j 

I II field / | 

L J. J 



dest 



Represents the destination code, which 
may be any terminal name in a terminal 
table entry. 



field 



Indicates the symbolic name of an 
optional field in a terminal table 
entry; this field, defined by the 
OPTION macro-instruction, contains the 
name of the terminal to which the 
message should be sent. If the source 
terminal is a non-polled device (e.g., 
a dial device) , the SOURCE macro- 
instruction must be specified in order 
for the "field" entry to be used. 
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Note: Only one DIRECT macro-instruction 
may be specified for a message type. The 
DIRECT macro-instruction cannot be used if 
the ROUTE macro- instruction is used for the 
same message. 



r t 1 

| Operation | Operand | 

J.-1 x -I 

| BREAKOFF | n | 

L X J 



Polling Limit (POLLIMIT) Macro- Instruction 



Specifies the maximum message length 
allowed, expressed in characters 
(n<32,767) . 



The POLLIMIT macro-instruction is used 
to determine whether a terminal has sent 
the maximum number of messages allowed on a 
single polling pass. When this maximum 
limit is reached, the next terminal is 
polled. 



RECEIVE OR SEND FUNCTIONAL 
MACRO- INSTRUCTIONS 



Date Stamp (DATESTMP) Macro-Instruction 



r t 1 

| Operation | Operand | 

h x ., 

| POLLIMIT ifFLl'nM j 

I |l field J | 

L X J 



The DATESTMP macro-instruction inserts 
the date in the header field of incoming or 
outgoing messages in the form byy.ddd, 
where b=blank r yy=year, and ddd=day of year 
(for example, b64.325). 



Specifies a limit for all of the 
terminals using the LPS. This option 
can only be used when the number of 
consecutive polls is the same for all 
terminals. 



field 



Specifies the symbolic name of an 
optional field in the terminal table 
that contains the limit of consecutive 
polls for each terminal. This method 
of specifying the polling limit allows 
a different polling limit to be set 
for each terminal. 



r t 1 

| Operation | Operand | 

^ + _: -i 

| DATESTMP | j 

L X J 

The user must reserve seven spaces for 
the date stamp in the buffer. (Refer to 
"Line Procedure Specification Start 
(LPSTART) Macro-Instruction. ") 



Time Stamo (TIMESTMP) Macro-Instruction 



Note: If no polling limit is set (POLLIMIT 
macro-instruction is not used) , each 
terminal is polled until the terminal has 
nc more messages for the polling pass. 



RESTRICTION: 
instruction 
dialing line. 



The POLLIMIT macro- 
has no effect when used with a 



Halt Receive (BREAKOFF) Macro- Instruction 



The TIMESTMP macro-instruction inserts 
the time of day in the header field of 
incoming or outgoing messages in the form 
bHH.MM.SS.th, where b^blank, HH=hours, 
MM=minutes, SS=seconds, t=tenths of sec- 
onds, and h=hundredths of seconds. When 
less than twelve spaces are reserved the 
time will be truncated from the right. 

r t 1 

| Operation | Operand | 

|. x ., 

| TIMESTMP | n | 

L X J 



n 



The BREAKOFF macro-instruction 
determines if the length of the received 
message exceeds the specified maximum num- 
ber of characters (n) . It also checks to 
see if the input buffer is filled with 
identical characters. If either of these 
conditions is found, an error flag is set 
in the error half-word and reception of the 
message is terminated. (Refer to "Error 
Handling Functional Macro- Instruct ions. ") 



Indicates the number of characters to 
be inserted in the message header 
stamp. The maximum value of n is 
twelve. The first character of the 
time stamp is always a blank. The 
user must reserve the necessary space 
for the time stamp in the message 
buffer. (Refer to "Line Procedure 
Specification Start (LPSTART) Macro- 
Instruction. ") 
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RESTRICTION: 



The 
may be 



TIMESTMP 
used only 



macro- 
when the 



instruction 

system includes interval timer capability. 



SKIP Macro-Instruction 



r t 

| Operation | Operand 

j. + 

| MODE | ( PRIORITY j 

| | J CONVERSE I , [C'char'] 

| | j INITIATE [ 

| | pothers J 

l x 



The SKIP macro-instruction causes 
skipping of either a designated number (n) 
of nonblank characters, or all characters 
up to and including a designated character 
configuration. The SKIP macro-instruction 
is provided to allow fields in the message 
header to be skipped during processing. 

r ~t 1 

| Operation | Operand | 

|. + -I 

| SKIP | [n] , [C* chars' ] | 

l 1 j 



Specifies the number of nonblank char- 
acters to be skipped. The maximum 
value of n is the number of characters 
remaining in the header. 



chars 



Indicates the nonblank character con- 
figuration designated to terminate the 
skip operation. This character con- 
figuration must not exceed eight char- 
acters - 



PRIORITY 

Causes scanning of the header to 
locate the next nonblank character. 
This character is the priority value 
assigned to the message by the subrou- 
tine. The sequence of increasing 
priority is A, . . . , Z,l , . . . ,9. 

CONVERSE 

Causes the line to be placed in tne 
conversational mode. The line is held 
open until an entire message is 
received and a reply has oeen sent. 
Messages that are already queued for 
transmission to the line or terminal 
are not sent during the conversation 
period. 

INITIATE 

Allows segments of an input message to 
be routed to an output queue before 
the entire message is received. For 
multiple-addressed messages, this 
routing option applies only to the 
first destination. 



Example: A SKIP macro-instruction to skip 
five characters would be: 



r t 1 

| Operation | Ooerand | 

j. + _: -i 

j SKIP j 5 j 

L 1 J 

A SKIP macro- instruction to skip charac- 
ters up to and including , would be : 



others 

Specifies the name of 
subroutine. 



char 



user-written 



Represents a specified character. 
This parameter may be omitted if an 
unconditional transfer to the desig- 
nated subroutine is desired. 



r t 1 

| Operation | Operand | 

H + ., 

I SKIP |,C\' | 

L i. J 



Message Mode (MODE) Macro-Instruction 



The MODE macro- instruction causes execu- 
tion of a designated function if the next 
nonblank header character found is the 
character specified in the char operand, or 
if the char operand is omitted. Otherwise, 
control returns to the next macro- 
instruction in the LPS. The MODE macro- 
instruction can be used more than once in 
the same LPS. 



End-of -Block (EOB) Macro-Instruction 



The EOB macro-instruction allows a ter- 
minal to continue sending a message after 
an end-of-block has occurred. This macro- 
instruction can be used only with an IBM 
1050 Data Communications System and must 
immediately fellow the ENDRCVE and ENDSEND 
delimiter macro-instructions. If the EOB 
macro- instruction is not supplied, the 
occurrence of an end-of-block is interpret- 
ed as an, end-of-transmission. 

r r 1 

| Operation | Operand | 

Y + -i 

| EOB | | 

L J. J 
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End-of- Block and Line Correction (EOBLC) 
Macro- Instruction 



The EOBLC macro- instruction has the same 
function as the EOB macro-instruction 
except that it also provides a procedure 
for line correction if a transmission error 
is indicated. This procedure provides for 
a retransmission of the message block that 
followed the previous end-of-block. The 
maximum number of retries is three. If the 
error is not corrected, an error indication 
is made in the error half-word. 

r t 1 

| Operation | Operand | 

j. + H 

I EOBLC | J 

L X J 



Logging (LOGSEG) Macro- Instruction 



If the characters are the same, the 
macro-instructions immediately following 
this macro-instruction are used to process 
the message. This process is terminated by 
the next delimiter. 

If the character is not the same, a 
transfer to the next MSGTYPE macro- 
instruction occurs and the same message 
type character is compared with the first 
operand of the new MSGTYPE macro- 
instruction. 

r t 1 

| Operation | Operand | 

|. + .| 

J MSGTYPE | J=C type code M j 

I llblank / | 

L ± J 

type code 

Specifies the character that 
identifies the message type code. 



blank 



The LOGSEG macro- instruction places mes- 
sage segments on a user-specified 
input/output device. This macro- 
instruction may be used in the receiving 
portion of the LPS to log incoming mes- 
sages, or in the sending portion of the LPS 
to log outgoing messages. 

r t 1 

| Operation | Operand | 

j. + ., 

| LOGSEG | dcbname | 

L J. j 

dcbname 

Represents the symbolic name of the 
DCB macro- instruction that the user 
must supply to define the parameters 
of the data set necessary for logging 
segments . 



Note: If the LOGSEG macro-instruction is 
the logged message segments are 
(i.e., the message segments 



used, 

interleaved 

will be recorded in the log in the order in 

which they arrive) . No attempt is made to 

group segments of individual messages. 

This logging is in addition to the queueing 

procedure of QTAM. 



Message Type (MSGTYPE) Macro- Instruction 



Indicates that the group of macro- 
instructions, which immediately follow 
the MSGTYPE macro-instruction, handle 
messages that were not identified by 
the previous MSGTYPE macro- 
instructions. 



Example : Part of a routine using 
macro-instructions is shown as: 



MSGTtfPE 



LPS1 



message 
not type 

"Tin 



LP START 



RCVHDR 

I- MSGTYPE 

SOURCE 



EOA 

^MSGTYPE 
SEQIN 



ENDRCVE* 



C** 



LPS instructions 
for handling 
type "P" message 



LPS instructions 
for handling the 
remaining mes- 
sage types 



RESTRICTION: 



_ The MSGTYPE macro-instruction 
be included after the RCVHDR or 



can only 

SENDHDR macro-instructions. 



The MSGTYPE macro-instruction is used 
when some of the messages on a line require 
a different LPS sequence from the other 
messages on the line. It examines the next 
nonblank character in the message header to 
determine if the message type character is 
the same as the character specified in the 
first operand. 



Translate (TRANS) Macro-Instruction 



The TRANS macro-instruction converts the 
characters of a message segment being 
received or sent from one code to another. 
Messages received are translated into an 
extended binary coded decimal interchange 



HO 



code (EBCDIC). Those that are sent are 
translated from this code to that of the 
destination terminal. Translating is done 
on a one-to-one character basis. 



SEND FUNCTIONAL MACRO- INSTRUCT IONS 



PAUSE Macro-Instruction 



r t 1 

| Operation | Operand | 

j. x -I 

| TRANS | table j 

L x j 



The PAUSE macro-instruction can be used 
to insert idle characters in an outgoing 
message upon recognition of a designated 
character, such as a carriage return. This 
macro- instruction, if used, must appear 
after the TRANS macro-instruction. 



table 



Specifies that the programmer must 
provide the name of the code conver- 
sion table. He may select tables 
provided by QTAM or define his own. 
The tables provided by QTAM are: 



r t t 

| Operation | Opera nd | 

h . + _, 

JPAUSE jX'char' ,nX'id' j 

l x J 



Tables Conversion 

SEND1050 EBCDIC to 1050 

5END1030 EBCDIC to 1030 

SENDT1 EBCDIC to 5-level Baudot 

SENDT2 EBCDIC to 8-level TWX 

RCVE1050 1050 to EBCDIC 

RCVE1030 1030 to EBCDIC 

RCVET1 5-level Baudot to EBCDIC 

RCVET2 8-level TWX to EBCDIC 

RCVF1050 1050 to Monocase EBCDIC 



char 



Is the hexadecimal representation of 
the special character that signals the 
insertion of the idle character (s) . 
The special character is in the code 
for the particular terminal device 
used. 



Specifies the number of 
ters to be inserted. 



idle charac- 



Note: Received messages must be translated 
into EBCDIC immediately after an RCVSEG 
macro- instruction, and messages to be 
transmitted must be translated into the 
appropriate line code as the last function 
before an ENDSEND macro-instruction. 



id 



Indicates the actual transmission code 
bit configuration of the idle charac- 
ter to be inserted. This is also 
specified in hexadecimal notation. 



The RCVF1050 table permits an IBM 1050 
Data Communications System to be effective- 
ly used with a 4 8- or 60-character 
System/360 installation. The operator keys 
all input messages in lower case so that no 
shifts are required between letters and 
numerals. The RCVF10 50 (Receive Folded 
1050) table converts upper and lower case 
letters into upper case EBCDIC. 



Sequence Out (SEQOUT) Macro-Instruction 



The SEQOUT macro-instruction is used to 
number sequentially ail outgoing messages 
for each terminal (or for a group code 
where applicable) . 



Numerals and special characters are not 
modified. If the output must include 
letter- numeral shifts, the SEND1050 table 
is used. This mode of operation offers the 
following three advantages : 



Operator procedure is simplified; case 
shifts are not required. 
Line time is saved since shift charac- 
ters are not sent from the terminal. 
Listing at the terminal will show all 
letters in messages from the terminal 
in lower case; all letters in messages 
to the terminal in upper case. 



r t 1 

| Operation | Operand | 

j. x _, 

j SEQOUT j n j 

L X J 



Specifies the number of characters to 
be inserted in the header for the 
output sequence number. The first 
character in the output sequence num- 
ber field is always a blank. The 
maximum field size that can be speci- 
fied is five; the range of numbers in 
the maximum-size field is from 0001 to 
9999. 
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ERROR HANDLING FUNCTIONAL 
MACRO- INSTRUCTIONS 



After reception or transmission of the 
entire message is completed, an error half- 
word for the applicable line indicates 
whether certain errors have been detected 
(Figure 6). It is the user's 
responsibility to check the code (in the 
error half-word) by using one of the error 
handling macro-instructions. If errors are 
detected, the designated action will be 
taken. An error half-word that contains 
all zeros indicates a normal completion. 



The macro-instructions, for interroga- 
ting the error half-word to determine what 
action should be taken for a given error, 
are listed below in alphabetical order. 



Cancel Message (CANCELM) Macro- Instruction 



The CANCELM macro-instruction causes a 
message to be canceled (the message will 
not be transmitted) if any of the errors 
specified by the mask have been detected. 

r t 1 

| Operation! Operand | 

h + .) 

j CANCELM | X' mask' j 

L X J 



mask 



mask 



Represents the bit configuration (in 
hexadecimal) used to test the error 
half-word. 



RESTRICTION: This macro-instruction, if 
used, must follow the ENDRCVE or ENDSEND 
macro- instruction delimiters. 



Error Message (ERRMSG) Macro- Instruction 



The ERRMSG macro-instruction causes an 
error message to be sent to a designated 
terminal when any of the errors specified 
by the mask have been detected. 



r t 1 

| Operation | Operand 

h + _j 

j | f=C'destM Nc'errtext'l) 

| ERRMSG I X' mask' ,< field V,\addr J\ 
| | t SOURCE J I 

L X J 



Represents the bit 
hexadecimal) used 
half-word. 



configuration (in 
to test the error 



dest 



Indicates the name of an entry in the 
terminal table to be used as the 
destination for the error message. 



field 



Indicates the symbolic name of an 
optional field in a terminal table 
entry; this field, defined by the 
OPTION macro-instruction, contains the 
name of the terminal to which the 
error message should be sent. If the 
source terminal is a non-polled device 
(e.g. , a dial device) , the SOURCE 
macro-instruction must be specified in 
order for the "field" entry to be 
used. 



SOURCE 

Indicates that the error message is to 
be returned to the source terminal. 
If the source terminal is a non-polled 
device, 1) the illegal source code bit 
(bit 6) should not be represented by a 
one in the bit configuration of the 
mask; and 2) the SOURCE macro- 
instruction must be specified. 



errtext > 

Indicates the actual text of the 
desired error message. The error mes- 
sage must not be longer than one 
message segment. If the first charac- 
ter of the message text is a period, 
QTAM precedes the message with the 
header of the message in error. 



addr 



Indicates the address of the first 
character of the error message. If 
the first character of the message 
text is a period, QTAM precedes the 
message with the header of the message 
in error. 



Note: If the header of the message in 
error is to precede the error message, the 
combined length of the header and error 
message must not exceed the length of one 



message segment. 



RESTRICTION: 



This macro-instruction, if 
used, must follow ENDRCVE or ENDSEND macro- 
instruction delimiters, or both. 
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9 10 11 12 13 14 15 



I I I I 
, ±- n J.-., J._, J~ 



I I 

J—, J---, 



I I I I 



, J.--, J.— L J_ 



Header Analysis Error Byte 



Illegal destination code J | 

Terminal inoperative J 

Sequence number high error J 

Sequence number low error ' 

Not used J 

Incomplete header 

Illegal source code 

Not used J 



Line Control Error Byte 



Transmission error J 

Time-out J 

Breakof f error J 

Insufficient buffers J 



Not used J 



For internal use by QTAM J 

Legend 

Illegal destination code (bit 0) 

Indicates that the ROUTE macro-instruction found a destination code that was not 
an entry name in the terminal table. This type of error causes an automatic 
cancellation of the message for that given destination. If a CANCELM macro- 
instruction is given for this error condition, any destination codes that fcllcw 
the invalid one, in the case of multiple-address messages, are also canceled. 

Terminal inoperative (bit 1) 

Indicates that the message was not sent to its destination because the send bit in 
the terminal-table entry for the destination terminal was turned off (that is, set 
to zero) . 

Sequence number high error (cit 2) 

Indicates that the SEQIN macro-instructicn found a message sequence number higher 
than the expected sequence number in the particular terminal entry of the terminal 
table. When this error is detected, the expected sequence number is unchanged. 

Sequence number low error (bit 3) 

Indicates that the SEQIN macro-instruction found the message sequence number lower 
than the expected sequence number in the particular terminal entiy of the terminal 
table. If this message is not canceled, there is more than one message from the 
given terminal with the same sequence number. When this error is detected, the 
expected sequence number is unchanged. 

Not used (bit 4) 



Incomplete header (bit 5) 

Indicates the message header did not terminate within the first mes 
prior to the first end-of-block. 



sage segment or 



Illegal source code (bit 6) 

Indicates that the SOURCE macro-instruction found that the message source field 
was in error. This error occurs when the message source field is not the same as 
that of the terminal that sent the message or, in the case of a dial system (no 
polling), the message source field is not an entry name in the terminal table. 

Not used (bit 7) 



Transmission error (bit 8) 

Indicates that an error occurred during transmission (sending or receiving), 
errors as longitudinal and vertical redundancy check cause this bit to be 
on. 



Such 
turned 



Time-out (bit 9) 

Indicates that a time-out occurred while sending or receiving. This error should 
be tested to determine if message rerouting or message intercepting is needed. 

Breakoff error (bit 10) 

Indicates that the EREAKOFF macro-instruction found a receiving message that 
either exceeded the maximum allowable message length or in which all of tne 
characters were the same in a buffer. 

Insufficient buffers (bit 11) 

Indicates that QTAM buffer assignment was not able to provide cuffers for an 
incoming message. This condition, when it occurs infrequently, may te corrected 
by asking for retransmission. Frequent occurrences of this condition, however, 
require that QTAM be redefined with mere buffers. 

Not used (bits 12-13) 

For internal use by QTAM (bits 14-15) 



Figure 6. Communications Line Error Half-Word As Interrogated by Error Mask 
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Intercept (INTERCPT) Macro-Instruction 



The INTERCPT macro-instruction causes 
the suppression of all message transmission 
to a terminal when any of the errors 
specified by the mask have been detected. 
The sequence number of the first 
untransmitted message is stored in the 
INTERCPT optional field of the terminal 
table entry, and the intercept bit is set 
to 1. No messages are transmitted to the 
terminal until the intercept bit is reset. 
This may be done by a problem program using 
the CHNGT macro- instruction, or by the 
RELEASEM macro-instruction. 



dest 



Indicates the name of an entry in the 
terminal table to be used as an alter- 
nate destination code. 



field 



Represents the name of an optional 
field in a terminal table entry that 
contains the name of the alternate 
terminal. If the terminals are non- 
polled devices, the SOURCE macro- 
instruction must be specified in order 
for the "field" entry to be used. 



r t 1 

| Operation | Operand | 

j. 1 .j 

[INTERCPT j X' mask' j 

i J. j 



mask 



Represents the bit configuration (in 
hexadecimal) used to test the error 
half-word. 



RESTRICTION: 



This macro-instruction, if 
follow the ENDSEND macro- 



used, must 
instruction delimiter. 

Note: A 2-byte field named INTERCPT must 
be provided in the optional area of the 
terminal table. (Refer to the "OPTION 
Macro-Instruction.") The intercept bit may 
be reset by a message processing task using 
the CHNGT macro- instruction or the RELEASEM 
macro- instruction. If the RELEASEM macro- 
instruction is used, all intercepted mes- 
sages are transmitted. If the CHNGT macro- 
instruction is used, only those messages 
that have not been bypassed in the queue 
are transmitted. 



MESSAGE PROCESSING TASKS 



It is the user's responsibility to write 
the message processing tasks for his data 
communication system. QTAM provides 
functions to aid in two areas of the 
message processing task's operation. 

• Queue access - macro-instructions pro- 
vide the ability to obtain messages 
from and place messages into a message 
queue. 

• Telecommunications system status 
macro-instructions provide the ability 
to examine or change such parts of the 
communications system as polling lists, 
terminal table entries, and message 
queues. 

The user must provide all other func- 
tions required in his message processing 
task. All services of System/360 Operating 
System may be used to aid in the provision 
of the needed functions. (Refer to IBM 
System/360 Operating System: Control Pro- 
gram Services . ) 



REROUTE Macro-Instruction 



QUEUE ACCESS 



The REROUTE macro-instruction causes a 
message to be queued for an alternate 
destination when any of the errors 
specified in the mask have been detected. 

r t 1 

| Operation! Operand | 

,. + _ H 

JREROUTE | X'mask' ,f=C destO | 

I I I field / | 

L J. J 



mask 



Represents the bit configuration (in 
hexadecimal) used to test the error 
half-word. 



The main connection between a user's 
message processing task and the message 
control task is the message queue. Input 
(process) queues store incoming messages; 
output (destination) queues store outgoing 
messages. Both message control and message 
processing tasks have access to these 
queues. 

A QTAM user must specify the unit of 
data with which his processing routines 
work. The work unit is specified in the 
data control block associated with the 
queue. The three options available are: 
record, message segment, or complete mes- 
sage. A complete message is defined by an 
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end-of- transmission character- A message 
segment is defined by a buffer length. A 
record is defined by either carriage 
return, line feed, combined carriage 
return-line feed, or an end-of-block. 
Record size and segment size have no neces- 
sary relationship. 



A user may also specify a priority 
queueing scheme. Instead of queueing mes- 
sages on a first- in-first-out basis, they 
may be queued on a first- in-first-out basis 
within each priority section of the queue 
(Figure 7) . 



The priority of each message must be 
specified in the message header. The MODE 
macro-instruction is then used in the mes- 
sage control task to check message priori- 
ty. 



Individual macro-instructions 
for access to message queues are 
lows. 



GET Macro-Instruction 



provided 
as fol- 



r t t i 

| Name | Operation | Operand | 

j. + + -| 

| | GET | dcbname,workarea | 

L J. X J 



dcbname 

Specifies the address of the input 
data control block that contains the 
parameters necessary to gain access to 
the desired queue. 

workarea 

Specifies the address of the area into 
which the desired segment, record, or 
message is placed. 

Note: The first four bytes in the workarea 
are either the record, segment, or message 
prefix. The first two of these bytes 
specify the number of characters in this 
record, segment, or message. The third 
byte specifies the message type (Table 9) . 
The last byte of the prefix is a zero. 

When a GET macro-instruction is issued 
and record work units have been specified 
in the data control block, the data 
transferred to the workarea includes all 
characters through the first carriage 
return, line feed, combined carriage 
return-line feed, or end-of-block charac- 
ter. 

PUT Macro-Instruction 



The GET macro-instruction obtains the 
next sequential segment,, record, or message 
from the input queue associated with the 
data control block referred to. Reference 
to an empty queue results in a wait status 
unless a user's EOCAD exit is provided in 
the associated data control block. 



The PUT macro-instruction places the 
desired message seqment or record into an 
output queue. The terminal table entry 
name of the message destination must be in 
the location specified by the TRMAD param- 
eter. 



The terminal table entry name of the 
message source, in the case of a polled 
terminal, is placed by the GET macro- 
instruction into the area whose address is 
contained in the TRMAD field of the data 
control block. If the source terminal was 
not a polled type, the terminal table entry 
name of the message source is placed into 
the address specified by TRMAD only if the 
SOURCE macro- instruction was given within 
the line procedure specification. 



r r t 1 

| Name | Operation | Operand | 

|. 1 + -i 

| | PUT | dcbname, workarea | 

L J. J. J 

dcbname 

Specifies the address of the output 
DCB macro-instruction that contains 
the parameters necessary to refer to 
the desired queue. 



Sequence into Q 


A 


B 


C 


D 


E 


F 


G 


Priority 


2 


3 


1 


2 


3 


3 


2 


Sequence Out 
of Queue 


B 


E 


F 


A 


D 


G 


C 



Output Message Queue 


Message 


B 


Message 


E 


Message 


F 


Message 


A 


Message 


D 


Message 


G 


Message 


C 



Priority 3 Messages 

Priority 2 Messages 
Priority 1 Message 



L J 



Figure 7. Message Priorities Within a Queue 
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Tatle 9. Segment-Type Byte Definition Chart 
r t t 



Segment- | 

Type Byte j | 

Contents | Message j Segment 



Record 



00000000 



j Header segment of a 
[multiple-segment message 



-+- 



Header record of a multiple-record 
message 



00000001 j 



Intermediate text segment 



Intermediate text record 
Single-record complete message 



00000010 j Completej Single- segment complete message 
j message j 



L_ 



00000011 i 

I 

J.. 



I Last text segment of a 
j multiple-segment message 
-X 



Last text record of a multiple- 
record message 



workarea 

Specifies the symbolic name of the 
area into which the desired segment, 
record, or message is placed. 



Note: The first four bytes in the workarea 
are either the record, segment, or message 
prefix. The first two of these bytes 
specify the number of characters in this 
record, segment, or message. The third 
byte specifies the message type (Table 9) . 
The last byte of the prefix is a zero. 



destination terminal 

Specifies the address of an area that 
contains the name of the message des- 
tination point, whether it be a single 
terminal device, a group code, or a 
process program. (It may not be the 
name of a distribution list.) Either 
this parameter or the "source 
terminal" must be provided if retrie- 
val is to be made by input or output 
sequence number. Only the first seg- 
ment of the message is retrieved. 
This parameter may be expressed as a 
symbolic name or as a register desig- 
nation, where the register contains 
the address of the name. 



RETRIEVE Macro-Instruction 



The RETRIEVE macro-instruction causes a 
message segment to be retrieved from the 
specified queue and placed into a user- 
provided workarea. The queue must be 
located on a direct-access storage device. 



r t t 

Name | Operation! Operand 




[ source terminal ^ 
1 destination terminal L 
] direct-access device f 
(., address 

flN 
workarea,, < OUT 

l^blankj 
fnumberl 
\blank / 



\ 



source terminal 

Specifies the symbolic name assigned 
to a message source point, whether it 
be a single terminal device or a 
process program. Either this paramet- 
er or the "destination terminal" par- 
ameter must be provided if retrieval 
is to be made by input or output 
sequence number. 



direct-access device address 

Indicates the relative record address 
of the segment on the direct-access 
storage device. This parameter must 
be provided if retrieval is to be made 
by direct-access device address. This 
parameter must be expressed as a reg- 
ister designation, where the register 
contains the 3-byte record address. 

workarea 

Indicates the address of the user- 
provided workarea into which the 
segment is placed. This parameter may 
be expressed as an explicit effective 
address, a symbolic relocatable 
address, or a designation of a reg- 
ister containing the address. 



IN 



OUT 



Indicates retrieval is to be by 
sequence number. 



input 



Indicates retrieval is to be by output 
sequence number. 



blank 



Represents the parameter left blank if 
retrieval is to be by direct-access 
device address. 
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number 

Represents actual input or output 
sequence number if retrieval is to be 
by sequence number. 

blank 

Represents the parameter left blank if 
retrieval is to be by direct-access 
device address. 

Note: Two methods are used to identify the 
message segment to be retrieved: 

• The terminal name and the input or 
output sequence number may be speci- 
fied, in which case the first segment 
(header segment) of the message is 
retrieved. The header prefix contains 
the direct-access device address 
(relative record address) of the next 
segment if it is a multisegment mes- 
sage. 

• The relative record address of the 
segment may be specified. Using the 
direct-access device address provided 
in the header segment by the first 
method, the second segment may be 
retrieved. Each additional segment may 
then be retrieved by specifying the 
direct-access device address provided 
in the previous segment. 



Copy Polling List (CPYPL) Macro-Instruction 



The CPYPL macro-instruction copies the 
polling list of a specified line into a 
specified workarea. 



r t t 1 

| Name | Operation | Operand | 

^ + x -i 

| | CPYPL | dcbname r r In, workarea | 
l x x J 



dcbname 

Specifies the name of the data control 
block for the communications line 
group containing the particular line. 



rln 



Specifies a register that contains the 
relative line number of the communi- 
cations line. 



workarea 

Specifies the address of the workarea 
in which the polling list is to be 
placed. The size of the workarea that 
must be provided can be determined 
from the polling list format shown in 
Figure 8. 



Release Intercept (RELEASEM) 
Nacro- Instruction 



The RELEASEM macro-instruction causes 
transmission to a terminal of all messages 
that have been intercepted for that termi- 
nal. (Refer to "INTERCPT Macro- Instruc- 
tion.") The intercept bit in the terminal 
table entry is set to zero. 

r t t 1 

| Name | Operation | Operand | 

(. + x ^ 

| | RELEASEM |termname | 

l x x J 

termname 

Represents the terminal name that 
identifies the terminal table entry. 



TELECOMMUNICATIONS SYSTEM STATUS 



The following macro-instructions enable 
the user to: 1) examine polling lists, 
terminal tables, and message queues; 2) 
change polling lists and terminal tables; 
and 3) activate or deactivate a particular 
line in a communications line group. 







N+l N+2 N+3 N+4 



r t t t - t t n 

I size | status | pointer^ | |pointer n | null | 
l x x x_x L J 



Legend 



size 

Indicates the total length of the 
polling list. 

status 

Indicates the current status of the 
polling list: if "1", the list is 
active; if "0", the list is inactive 
and no polling is done on this line. 

pointer 

Represents the addresses of the 
first byte of each terminal table 
entry associated with this polling 
list, relative to the first byte of 
the terminal table. 

null 

Identifies the end of the present 
polling list. Null is always speci- 
fied as "OCT. 

Figure 8. Polling List Formats 
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Change Polling List (CHNGPL) 
Macro- Instruction 



The CHNGPL macro-instruction places a 
new polling list into the polling list area 
specified for the line or changes the line 
status with regard to polling. 

r t t 1 

| Name | Operation | Operand | 

Y + -}- 1 

| | CHNGPL | dcbname, rln, (workarea | | 
I I I <=C0' 

I I I l=C'l' 

L J. X J 

dcbname 

Specifies the name of the data control 
block that provides control informa- 
tion that pertains to a line polling 
list. 

rln 

Specifies a register that contains the 
binary relative line number within the 
communications line group for which 
the polling list is defined. 

workarea 

Specifies the address of the area that 
contains the new polling list. The 
new polling list must not contain more 
entries than the original polling 
list. It must be of the format shown 
in Figure 8. If the new polling list 
is larger, it is not used. Bit 1 of 
the first byte of the workarea, howev- 
er, is used as a return code to 
indicate the error. 



Conditions the line not to receive 
incoming messages. 



Conditions the line to start polling 
with the previously specified polling 
list. 

Note: For common carrier TWX networks, 
only the condition change can apply (i.e., 



or 1 can be specified) . 



Start Line (STRTLN) Macro- Instruction 



If the IDLE entry is specified in the 
OPEN macro-instruction for the line group, 
the STRTLN macro-instruction must be issued 
before initial message transmission can 
take place. If the IDLE entry is not 
included in the OPEN for the line group, 
STRTLN is not required for initial message 
transmission. If a line is deactivated by 
a STOPLN macro-instruction, STRTLN must be 
issued before message transmission on that 
particular line can resume. 

In all the above cases, if polling is 
used, the presence of an active polling 
list is a prerequisite for message 
transmission. (An active polling list is 
one in which the second byte of the list is 
a non-zero character — this character is 
initialized as a 1 and can be changed by 
the CHNGPL macro-instruction.) If STRTLN 
is used, polling begins after the execution 
of that macro- instruction. If the IDLE 
entry is not specified in the OPEN for the 
line group, polling begins following the 
execution of the OPEN macro-instruction. 

r t t 1 

| Name | Operation | Operand | 

y + + _ ^ 

I I I /rlnl | 

| [symbol] | STRTLN | dcbname,\ALL / j 

l x x J 

symbol 

Specifies the name for the STRTLN 
macro-instruction. 

dcbname 

Specifies the name of the data control 
block for the communications line 
group containing the line to be acti- 
vated. 



rln 



ALL 



Specifies, in decimal, the relative 
line number of the line to be activa- 
ted. If this number is enclosed in 
parentheses, it is interpreted as 
specifying the number of a register 
containing, in binary form, the rela- 
tive line number of the line to be 
activated. 



Specifies that all the lines in the 
communications line group should be 
activated. 



The STRTLN macro- instruction can be used 
to: 1) allow message transmission to com- 
mence or resume on a particular line in a 
communications line group; and 2) allow 
message transmission to occur on all lines 
in a communications line group. The user 
must previously have issued an OPEN macro- 
instruction for the line group. 



Stop Line (STOPLN) Macro-Instruction 



The STOPLN macro-instruction removes . a 
communications line from active use. This 
macro- instruction has the following 
effects: 
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Operations on the line designated are 
stopped. If the line was conditioned by a 
CHNGPL macro- instruction to stop receiving, 
all messages queued for transmission on the 
line are transmitted before control is 
returned to the program issuing the STOPLN 
macro-instruction. If the line was not 
conditioned to stop receiving, control is 
returned to the program issuing the STOPLN 
macro-instruction immediately after the 
completion of any message being transmit- 
ted. In the latter case, transmission of 
any messages remaining in the queue for the 
line resumes when a STRTLN macro- 
instruction reactivates the line. 

r t t 1 

| Name | Operation | Operand | 

|. + 1 ., 

| [symbol] | STOPLN |dcbname,rln | 

l x x J 



symbol 



Specifies the name 
macro- instruction. 



for the STOPLN 



area 

specifies the address of the area into 
which the information is to be placed. 
The first byte of the area is reserved 
for a return code. The table data 
always starts in the second byte. 

The format of the terminal table entry 
copied by a COPYT macro-instruction depends 
on whether it is a single entry terminal, a 
group code entry, a distribution list 
entry, or a process program entry. 

Since the maximum size of a terminal 
table entry is 255 bytes, the maximum size 
of the workarea that must be provided for a 
type of entry is 256 bytes (255 bytes plus 
return code byte) . The user may, however, 
conserve storage space by determining the 
actual size of each entry type from the 
terminal table entry formats illustrated in 
Figure 9 and provide workareas for those 
sizes only. 



dcbname 

Specifies the name of the data control 
block for the communications line 
group containing the line to be 
deactivated. 



rln 



Specifies, in decimal, the relative 
line number of the line to be deacti- 
vated. If this number is enclosed in 
parentheses, it is interpreted as 
specifying the number of a register 
containing, in binary form, the rela- 
tive line number of the line to be 
deactivated. 



Change Terminal Table (CHNGT) 
Macro- Instruction 



The CHNGT macro-instruction causes a 

complete terminal table entry to be moved 

from a designated area into a specified 
entry of the terminal table. 

r t t t 

| Name | Operation | Operand | 

y + + -i 

| | CHNGT | termname,area | 

L J. X J 



Copy Terminal Table (COPYT) 
Macro- Instruction 



The COPYT macro- instruction causes the 
information contained in a specified entry 
of the terminal table to be moved into a 
designated area. 

r t t 1 

| Name | Operation | Operand | 

,. 1 + H 

| | COPYT | termname,area | 

l x x J 

termname 

Specifies the name of the terminal 
with which the entry is associated. 
An invalid name will cause the macro- 
instruction to be terminated. Bit 
of the first bytes in the workarea 
will be made a return code to indicate 
the error. 



termname 

Specifies the terminal name with which 
the entry is associated. An invalid 
terminal name causes the macro- 
instruction request to be terminated. 
Bit of the first byte in the 
workarea is used as a return code to 
indicate the error. 

area 

Specifies the address of the area from 
which the information is to be moved. 
The first byte of the area is reserved 
for a return code. The new table data 
must always start in the second byte. 

Note: The CHNGT macro-instruction causes 
the entire contents of a current entry to 
be overlaid. It is normally preceded by a 
COPYT macro-instruction and some modifica- 
tion to the copied entry. If the new entry 
is larger than the current one, it is not 
used and bit 1 of the first byte of the 
workarea is used as a return code to 
indicate the error. 
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Single Terminal Entry 

Eyte 12 3 



8 



|— 8 Bytes Maximum- 



T T T T T T- 

| TNTRYSZE j TQCBADDR j TSEQUIN | TSEQOUT j TSTATUS j 
L JL J. X X X. 



TERMID 



^ 

USER AREA 



246 Bytes Maximum 

^ 



-iV- 



DEVICE ACCESS AREA 

^ j. 



Group Code Entry 

I I 

Eyte 123 45 67 8 |-8 Bytes Maximum-*! 

| TNTRYSZE | TQCBADDR v////////A TSEQOUT | TSTATUS | TERMID | 



2U6 Bytes Maximum 



| USER AREA | DEVICE ACCESS AREA | 

l ^ y x ^ y j 



Distribution List Entry 
Byte 1 



r t 

| TNTRYSZE | TDSTRQCB 
L X 



2 3 4 5 
V777 r 



7 8 | -8 Bytes Maximum-* | 



Y//A TLISTKEY {////A TSTATUS | TERMID | 



TERMREF1 



246 Bytes Maximum — 

— , v 

TERMREF2 



-JV 



TERMREFN 



Process Program Entry 
Byte 1 



TNTRYSZE | TQCBADDR 



2 3 4 5 6 

"vrrrrrrrrr^' 



j-8 Bytes Maximum->| 
r -iV- 1 



\/////////A TSEQOUT | TSTATUS | TERMID 



Legend 



Single Term Entry 



Is generated by the TERM macro-instruction. It provides data needed to support a 
terminal that can send or receive messages. The following subfields are contained 
in this entry : 

TNTRYSZE 

Is provided by the macro generator. It specifies the size (in bytes) of the entry 
and provides access to the next higher table entry. Since its value range is 1 to 
255, the size of an entry is limited to 255 bytes. 

Start location - byte 0. 
Length - 1 byte. 
Form - binary number. 



Figure 9. Terminal Table Entry Formats (Sheet 1 of 4) 
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TQCBADDR 

Is provided by QTAM. It contains the address of the control block that controls 
the queue in which outgoing messages to this terminal are stored. Using this 
address identification, the queueing routine places each message into its 
appropriate outgoing queue. 

Start location - byte 1. 
Length - 3 bytes. 
Form - binary address. 

TSEQUIN 

Is provided by QTAM to store and maintain a master sequence number for incoming 
messages from this terminal. It is initially set to a value of 1. 

Start location - byte 4. 
Length - 2 bytes. 
Form - binary count. 

TSEQOUT 

Is supplied by QTAM to provide a master sequence number for messages being sent to 
this terminal- It is initially set to the value of 1. 

Start location - byte 6. 
Length - 2 bytes. 
Form - binary count. 
TSTATUS 

Is used to indicate various communication conditions associated with the entry. 

Start location - byte 8. 

Length - 1 byte. 

Form - binary status bits . 

Bits through 4 (not used). 

Bit 5 The intercept bit is initially set to a value of 0. The bit is set to 
1 when the user specifies the INTERCPT macro-instruction. This 
indicates that a message in the queue has been skipped as a result of a 
transmission failure. It is turned off by the user (CHNGT 
macro-instruction) when transmission can be resumed, or by the RELEASEM 
macro- instruction. 

Bit 6 The send bit is initially set to a value of 1. This setting indicates 
that a message may be sent to the terminal. It is set to when the 
user specifies the INTERCPT macro- instruction. The bit is set to 1 
again when the user specifies the CHNGT macro-instruction, or by the 
RELEASEM macro-instruction. 

Bit 7 The receive bit is initially set to a value of 1. This indication 
means that the terminal may be polled for a message. The user can 
prevent the polling of a terminal by setting the bit to by specifying 
the CHNGT macro-instruction. Polling is resumed when the bit is set to 
1 again. 

TERMID 

Indicates the terminal name of the entry that must be specified by the user as a 

macro-instruction operand. The name of the entry is also the terminal code that 

may appear in the source or destination field of the message header. 

Start location - byte 9. 
Length - 1 to 8 bytes. 
Form - BCD characters. 

Figure 9. Terminal Table Entry Formats (Sheet 2 of 4) 
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USER AREA 

The storage allocation for each optional subfield that comprises the user area is 
created by repeated contiguous specification of the OPTION macro-instruction. 
There must be one OPTION macro-instruction specified for each required subfield. 
They must immediately follow the TERMTBL macro-instruction. The subfield storage 
allocation requested is repeated in each terminal table entry created by a TERM 
macro-instruction. A user area for the other entry types cannot be specified. 

Data to be inserted into each subfield of the user area must be specified by 
the user in the relevant operand of each TERM macro-instruction. The data 
specified must have a one-to-one correspondence with each requested subfield. The 
user area could be used for such data as alternate terminal code, polling limit 
parameter, diagnostic information, traffic data, or status bits. 

Start location - dependent upon the specified length of the TERMID subfield. 

Symbolic references may be made to the optional subfields named by the user 

for this area. 
Length - variable as required to store the optional subfields specified. 
Form - as specified for each subfield. 

DEVICE ACCESS AREA 

Contains the address characters needed to poll and address the terminal device. 
They are specified by the user in the addressing operand of the TERM macro- 
instruction. 

Start location - address of the first byte that follows the last byte of the 

user area- 
Length - variable as required to store the user-defined address data. 
Form - transmission code. 

Group Entry Code 



Is generated by the TERM macro-instruction. The entry created is identical to 
that of a single terminal with the following considerations: 

The terminal name specified by the user represents a prespecified group of terminals 
on a line that is equipped with special equipment. This feature permits a message to 
be sent simultaneously to a group of terminals by specifying a single set of unique 
address characters. Several combinations of prespecified terminals can be grouped for 
this purpose. Each group is given a group terminal name and a corresponding group code 
terminal table entry. 

Note; This type of line can also be sent messages for a single terminal when ordinary 



address characters are used. 

The master sequence number for outgoing messages (subfield TSEQOUT) is incremented 
by one when the group is simultaneously sent a message. If any terminal in the group 
is also associated with a single terminal entry*, the message number of that entry is 
not changed. 

The master sequence number for incoming messages (subfield TSEQUIN, bytes 4 and 5, 
in the single terminal entry) is not applicable to the group code entry because the 
terminal group cannot collectively send a message to the system. For the same reason, 
there are no polling characters in the device access area of the entry, and the receive 
bit of the TSTATUS subfield is never interrogated. 

L 

Figure 9. Terminal Table Entry Formats (Sheet 3 of 4) 
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Distribution List Entry 



Is generated by the LIST macro-instruction. The terminal name of the entry 
represents a list of terminals specified within the entry. When the entry 
terminal name is used as a destination code, the associated message is sent to all 
terminals of the list via separate transmissions. Each terminal of the list, 
therefore, must have a corresponding single terminal entry. The following 
subfields are valid for this entry: 

TNTRYSZE (same as single terminal entry) . 

TDSTRQCB 

Is the same as TQCBADDR in the single terminal entry, except that this address 
identifies a control block that controls a queue used for all distribution list 
messages. 

TLISTKEY 

Provides the access key to start the terminal list (subfield TERMREF) . It is a 
relative address value, relative to byte of the entry. 

Start location - byte 6. 
Length - 1 byte. 
Form - binary number. 

TSTATUS 

Is the same as the single terminal entry, except that the receive bit (bit 7) is 
never referred to because the terminals of the list cannot collectively send a 
message to the system. 

TERMID 

Is the same as the single terminal entry, except that the terminal name represents 
the list of terminals in the entry. 

TERMREF 

Specifies that each terminal is listed as a relative address that locates the 
entry of that terminal in the terminal table. The address is relative to the base 
address of the table. The high order bit of the last TERMREF entry will be a 1 
indicating the end of the TERMREF list.' 

Start location - follows TERMID. (See description of TLISTKEY above.) 
Length - 2 bytes for each terminal of list. 
Form - binary relative address. 

Process Program Entry 



Is generated by the PROCESS macro-instruction. The terminal name of thxs entry 
represents a message queue associated with a message processing program. The 
following subfields are valid for this entry: 

TNTRYSZE (same as single terminal entry). 

TQCBADDR (same as single terminal entry). 

TSEQOUT (same as single terminal entry) . 

TSTATUS 

Is the same as the single terminal entry, except that the receive bit (bit 7) is 
not applicable. 

TERMID 

Is the same as the single terminal entry, except that the terminal name specified 
identifies a message queue for a message processing program. This name is used as 
a header destination code to address a message to the queue. 

L . 

Figure 9. Terminal Table Entry Formats (Sheet 4 of 4) 
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Copy Queue Status (CPYQ) Macro- Instruction 



The CPYQ macro-instruction places 
information that concerns the status of a 
specified message queue into a workarea. 



r t t 1 

| Name | Operation] Operand | 

j. x x ., 

| | CPYQ | name, workarea | 

L x x j 



name 



Specifies the address of an entry in 
the terminal table. Only terminal 
table entry names of TERM or PROCESS 
macro- instructions may be specified in 



the CPYQ macro-instruction. An inval- 
id name causes the macro-instruction 
request to be terminated. Bit of 
the first byte in the workarea is used 
as a return code to indicate the 
error. 

workarea 

Specifies the address of the area 
designated to receive the queue status 
information. The first byte of the 
area is reserved for a return code. 
The queue status information always 
starts in the second byte. The wor- 
karea provided must be 7 bytes or 13 
bytes long, depending on the type 
queue to be copied (main storage queue 
or direct-access queue) . The format 
of the queue status information is 
illustrated in Figure 10. 



Main Storage Queue 



2 

QSTART 



3 4 
— T" 



19 



L X X 

Direct-Access Storage Device 

1 2 

r t 

| I QSTART 



3 4 

— T~ 



X X 



-ih 



21 22 

T 



31 



QSIZE 
-X X 



X X Jf. J 



19 20 21 22 23 24 25 29 30 31 

t r t // t 1 

I QSIZE JQNASEG | |QBACK| 
X X X ff. X J 



h ., 

Legend 



QSTART 



QSIZE 
QNASEG 



QBACK 



Indicates the starting address in main or direct-access storage of the first 
message in the queue; i.e., the next message to be processed or transmitted. 
For direct-access storage devices, the address represents the relative record 
number within the queueing area. 

Indicates the number of messages in the queue. 

Indicates the starting address, on a direct-access storage device, where the 
next message for this queue will be placed. 

Indicates the starting address, on a direct-access storage device, of the last 
message processed or transmitted from this queue. 



Figure 10. Queue Status Information Formats 
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Note; If the line queueing option is 
specified in the terminal table entry, the 
queue status information copied reflects 
the status of the queue for the entire 
line. 



A user program of the structure illus- 
trated in Figure 11 is a task. The 
"process message" section of the structure 
may contain any operations available in 
System/360 Operating System. For addition- 
al information regarding task scheduling 
within the operating system, refer to the 
publication IBM System/360 Operating Sys- 
tem: Concepts and Facilities . 



MESSAGE PROCESSING TASK APPLICATIONS 



In addition to writing message process- 
ing tasks, a user must perform the follow- 
ing: 



Define all queues used by his program. 
This is done at assembly time with the 
DCB macro-instruction. 

Open each queue used by his program 
with an OPEN macro- instruction, before 
any reference to the queue is made. 
Close each queue when no further ref- 
erence to the queue is necessary . 



Message processing tasks are considered 
to be in the following basic areas : 



Data collection application. 

Message switching application. 

Inquiry application. 

Operator control. 

Remote stacked job application. 



Figure 11 illustrates a possible struc- 
ture for a user program. It is assumed 
that no EODAD parameter was specified in 
the DCB macro- instruction for the data 
control block referred to in the GET macro- 
instruction. Thus, if no messages are in 
the queue, the program is placed in a wait 
status and is reentered only when 
additional messages arrive. 



DATA COLLECTION APPLICATION 



In a data collection application, mes- 
sages are sent from remote terminals to the 
central system (Figure 12) . There they are 
accumulated to be batch-processed. 



OPEN 



r 1 

| Initialize! 
l J 



GET 



Since the input queues specified in the 
"Message Control Task" section of QTAM may 
be located on a direct-access storage 
device, they may also be retained and 
processed later, thus fulfilling the data 
collection application. Another method of 
accumulating this data within QTAM is by 
use of the LOGSEG macro-instruction to 
accumulate data on a separate input/output 
device. 



r t 

| Process | 
| Message | 

L J 



The program used to process the data 
collected is scheduled as a separate task 
through the task scheduler. 



PUT 



BRANCH 



r t 

| Clean up | 
l J 



CLOSE 
L J 

Figure 11. Possible Structure for a User 
Program 



MESSAGE SWITCHING APPLICATION 



In a message switching application, mes- 
sages are sent from a remote terminal that 
has as its destination other terminals or 
groups of terminals. These messages 
require no intermediate processing 
(Figure 13) . 
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Figure 13. Message Switching 



INQUIRY APPLICATION 



In an inquiry application, messages are 
sent from remote terminals- The messages 
contain data to be processed, and require a 
reply to be sent back to the terminal. The 
programs used to process the messages may 
or may not be resident in main storage. 



If desired, an inquiry application can 
be operated in a conversational mode by 
inclusion of the CONVERSE parameter in the 
MODE macro- instruction in the LPS. In this 
mode, a terminal transmitting a message 
into the system is held on-line until the 
response is generated and sent from the 
central system- 



Figure 14 illustrates two basic methods 
of incorporating user-provided processing 
programs. With either method, the struc- 
ture of the user program is as shown. The 
only difference is the way in which the 
message is processed after it is obtained 
from a queue. 



The left-hand side of Figure 14 rep- 
resents a case in which the processing 
program issues the GET and PUT macro- 



instructions. This would most likely be a 
short processing program that is resident 
in main storage. 



A more involved situation is shown on 
the right-hand side of Figure 14. In this 
case, the program issuing the GET and PUT 
macro- instructions links (via the LINK 
macro-instruction) to another program. As 
shown in the diagram, the program may use 
data from input/output devices for 
processing the message, provided the 
required data management access method is 
included in the operating system. (Refer 
to the publication IBM System/360 Operating 
System: Data Management . ) 



The reply message in either case is 
routed to a terminal (usually the terminal 
sending the input message) by use of the 
PUT macro-instruction which places the mes- 
sage in the appropriate output queue. QTAM 
provides for the actual sending of the 
message. 



If both unsolicited messages and inquiry 
responses are directed to the same termi- 
nal, the order in which they are transmit- 
ted is unpredictable. 
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Figure 1H. Inquiry Application 



OPERATOR CONTROL 



Control messages may be entered into the 
system through a local terminal to obtain 
and modify the status of the telecommunica- 
tions system. 

The user may provide a task to analyze 
operator requests that may examine or 
dynamically modify the status of the tele- 
communications system (message control 
task) . Upon input of such requests, tele- 
communications system status macro- 
instructions can be used within user- 
provided routines to obtain the system 
status and generate a report to the 
operator, or effect a change in the system 
as specified by the operator. 



As shown in Figure 15, the operator 
request can be entered into the system by a 
local terminal. The operator request is 
then handled in the same manner as in the 
inquiry application. 



REMOTE STACKED JOB APPLICATION 



A remote stacked job application 
involves messages that contain programs, or 
programs and data. These programs may 
require: 

• Execution. 



• Compilation or assembly before execu- 
tion. 

• Compilation or assembly only. 



An example of a remote stacked job 
application is the remote entering of a 
FORTRAN source deck followed by a data 
deck. This application is identical to a 
normal stacked job, except the reception 
and transmission of the job is via communi- 
cations lines. 



System/360 Operating System provides the 
user with the ability to bring remote 
stacked jobs into the system, to execute 
them, and to transmit job output to remote 
terminals. Job output is independent of 
the source of input; i.e., any terminal 
which has been defined in QTAM can receive 
output from any job which specifies tnat 
terminal. Routing of job output to a 
terminal or local device is controlled by 
the disposition field of a DD card. 



A remote stacked job application is 
handled in the following manner: 

1. The QTAM message control task is 
assembled by the user with one or more 
LPS's capable of routing stacked job 
input to the processing queue which 
the user has defined. No special 
processing is required other than 
translating and routing. The proces- 
sing queue has no special attributes 
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Figure 15. Operator Control 



other than its name. No special pro- 
cessing of job output is required 
other than translating; however, the 
user may supply any functions that he 
desires within the SEND LPS structure. 
The QTAM message control task is 
introduced into the system through the 
normal input stream. 

A Tele-processing reader/interpreter, 
which uses input from the process 
queue, is attached in the normal man- 
ner for a reader. (Refer to the 
publication IBM System/360 Operating 
System: Operating Considerations . ) 
Remote stacked jobs are entered 
through any of the terminals attached 
to the system. Normal job input for- 
mat must be used, except that non- 
significant columns at the end of 
cards may be omitted; however, the 
records must be formed into 
80-character card images if this is 
done. The end of a remote stacked job 
input is indicated by an end-of- 
transmission. 

The job is scheduled for execution by 
the job scheduler. 

A Tele-processing output writer, which 
dispatches output to a terminal 
through QTAM, is attached in the nor- 



mal manner for a writer. (Refer to 
the publication IBM System/360 Operat- 
ing System: Operating Considerations . ) 



The following considerations 
noted: 



should be 



1. QTAM must be in the system whenever a 
Tele-processing reader/interpreter or 
a Tele-processing output writer is 
attached, or when a job specifying a 
terminal is executed. 

2. QTAM can stack remote jobs indefinite- 
ly; i.e., a Tele-processing reader 
interpreter need be attached only when 
execution is desired. 

3. Ttie Tele- processing reader/interpreter 
and the Tele-processing output writer 
can be detached in any of the follow- 
ing ways: 

• By a command from a remote termi- 
nal, which is routed to the proc- 
ess queue for the reader/inter- 
preter. 

• By a command from the system con- 
sole. 

• By a command to another reader/ 
interpreter. 
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SUMMARY CHARTS 



Summary charts list all macro- 
instructions that can be used with QTAM. 
They show where each macro-instruction can 
he used and note any restrictions that 
might affect their use. The macro- 
instructions are listed in alphabetical 
order within each chart so that they may be 
used for reference. The summary charts are 
divided into the following categorized 
macro-instruction charts: 

• Telecommunications system specification 
macro-instructions (Table 10), which 
include those macro-instructions that 
must be specified for both the message 
control and message processing tasks. 

• Message control macro-instructions for 
specifying line procedure specifi- 
cations (Table 11). This table lists 
all the delimiter and functional macro- 



instructions. The functional macro- 
instructions are identified with the 
appropriate delimiter macro- 
instructions that they can follow. 
Macro-instructions, which are delimi- 
ters, are indicated in the last column 
of the table. 

Message control macro-instructions for 
specifying QTAM control information 
(Table 12) , which includes those macro- 
instructions needed to provide detailed 
information in the form of tables and 
lists and to provide buffers for 
message handling. 

Message processing macro-instructions 
(Table 13) , which includes those macro- 
instructions that may be specified 
within the user's message processing 
programs to communicate with the mes- 
sage control task. These macro- 
instructions are separated into queue 
access and telecommunications system 
status categories. 



Table 10. Telecommunications System Specification Macro- Instructions 
r t t T - 



Name 



Operation 



+- 



Operand 



-+ 



Message 
Control 
Task 



-+ 



Message 

Processing 

Task 



[symbol] 



CLOSE 



4- 



(dcbname ± , , . . . dcbname n ) 



",/MF L V 

\MF (E,listname)J 



diskqueue dcbname |ECB 
-+■ 



keyword parameters 



linegroup dcbname j DCB 
+ ____ 

log dcbname | DCB 



keyword parameters 



+- 



-+• 



keyword parameters 



process dcbname | DCB 
+ 

[symbol] |OPEN 



keyword parameters 



( dcbname! , 



[INPUT ^ 
(< OUTPUT) [, IDLE]) 
IjNCUT J 



[INPUT ] 
(< OUTPUT >[,IDLE]) 

Uncut J 



dcbname n , 

f MF=L 1 

, \ MF=(E,listname)J 
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Table 11. Message Control Macro- Instructions for Specifying Line Procedure 
Specifications 









Functional Macro- Instructions and 


the 














D 






Delimiter Macro- Instructions Each May 


Follow 












J 


E 
L 






























1 R 1 


R | 


E 




S | 


S | 


E j 


I 










1 c 1 


C | 


N 




E j 


E | 


N | 


M 










1 v 1 


V | 


D 




N | 


N | 


D | 


I 










1 s 1 


H | 


R 




D | 


D j 


S | 


T 










1 E 1 


D 1 


C 




S | 


H | 


E | 


E 










1 G | 


R | 


V 




E j 


D | 


N j 


R 


Name 




Operation 


Operand 






E 




G | 


R | 


D | 


S 




-+• 




BREAKOFF 

CANCELM 

DATESTMP 

DIRECT 

ENDRCVE 

ENDS END 

EOA 

EOB 

EOBLC 




n 
X'mask' 

dest 

C'char' 

f^C'dest'^ I^C'errtextM 
X'mask* ,< field >,\addr J 


+ +" 

1 x 1 


X. 

x j 

1 1 

2 1 


X 

3 
3 


+• 


X. 


x j 


+ . 

3 1 
3 1 


X 

X 






ERRMSG 






X 








x j 










^SOURCE J 






















INTERCPT 


X'mask' 














x j 








LOGSEG 


dcbname 


1 x 1 


x j 






X j 


x j 






label 




LPSTART 
MODE 

MSGTYPE 


[n] 

[PRIORITY"^ 

< CONVERSE V , [C'char'] 

^INITIATE J 
others 
f=C type code '"I 
V blank / 




x j 








X j 




4 










X j 








X j 










PAUSE 


X'char^nX'id" 










X j 












POLLIMIT 


/ FLl'n' \ 
\ field J 






X 






































POSTRCVE 


















5 






POSTSEND 




1 * 1 














6 






RCVHDR 


















X 






RCVSEG 


















X 






REROUTE 


X'mask' , f=C*dest'"\ 
\field / 




























X 








X j 








ROUTE 


n 




X j 


















SENDHDR 


















X 






SENDSEG 


















X 






SEQIN 


[n] 




7 | 


















SEQOUT 


n 












X j 










SKIP 


tn] f [C'chars'] 




X j 








X j 










SOURCE 


n 




X j 


















TIMESTMP 


n 




X j 








X j 










TRANS 


table 


1 x 1 








X j 









X X X L L L I L X 



legend 



Used in place of ROUTE macro-instruction. 

First macro- instruction after ROUTE macro-instruction when multiple addressing is 

possible. 

Specified only when 1050 Data Communications Systems are used and must immediately 

follow ENDRCVE and ENDSEND macro-instruction delimiters. 

First macro- instruction of an LPS. 

Last macro- instruction for LPS receive. 

Last macro-instruction for LPS send. 

In a dialing system, SEQIN must follow the SOURCE macro-instruction. 
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Table 12. Message Control Macro-Instructions for Specifying QTAM Control 
Information 



- T n 

| Function of Given Message Control 
Macro-Instructions 



Name 



Operation 



I-- 



Operand 



| Terminal Table 
Specifications 



Polling List | Buffer 
Definition | Assignment 



BUFFER 



[dcbname] ,n, length 



entry 



LIST 



( entrya. , . . . ,entry n ) 



symbolic 
name of 
subfield 



OPTION 



subfield type and length 



pollname 



POLL. 



(entry!, . . . ,entry n ) 



entry 



PROCESS 



[EXPEDITE] 



-I- 



entry 



TERM 



ill 



dcbname, rln, addressing, j 

I 
[ (optdata ± , . . . , optdata n ) ] | 



|TERMTBL | entry 
_x x 



legend 



1- Must directly follow TERMTBL macro-instruction. 

2. Must be the first macro-instruction specified for terminal table. 



Table 13. Message Processing Macro- Instructions 
r t t t 



| | | Function of Given Message Processing 
j j j Macro-Instructions 


II r t t 

| | | |Telecommuni- | 
j j j j cations System j Line Activation 
Name j Operation! Operand | Queue Access j Status jand Deactivation 

J X X X 1 X 

| CHNGPL | dcbname, rln,f workarea^ | | x | 

1 1 <=co' V | | | 

1 1 ^C'l' j \ | | 
X X X 1 X 

| CHNGT | termname,area | | x | 

X X X X X 

| CPYPL | dcbname, rln, workarea | | x | 

X X X X X 

| CPYQ | name, workarea | | x | 

X X X X X 

| COPYT | termname, area | | x | 

X X X X X 

| GET | dcbname, workarea | x | | 

X X X X X 

| PUT | dcbname, workarea | x | | 

X X X X X 

| RELEASEM | termname | x | | 
1 { X + + 

1 | [source terminal j | x | | 
j j J destination terminal I, j j j 
| RETRIEVE j ] direct-access device] j j j 
j j L address J j j j 

i i r™ ^i i i i 

| | workarea, < OUT >, fnumber\| | | 
j | tblankj \blank J\ | | 

1 X X + X 

symbol | STRTLN | dcbname, frln "I | | | x 
1 1 lAILj 1 | | 



1— 



F X X X 1 1 H 

I symbol I STOPLN | dcbname, rln | | | x | 

l x x x x l J 
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BASIC TELECOMMUNICATIONS ACCESS METHOD 



Routines for handling line, terminal, 
control unit, and device oriented functions 
are included in the basic telecommunica- 
tions access method (BTAM) - This method 
also provides macro- instructions that en- 
able a user to read a message segment into 
the computer and write a message segment 
onto a communications device. The user, 
who does not require the queueing and 
analysis functions of QTAM, may use BTAM. 

Facilities provided by BTAM include: 

• Terminal polling. 

• Terminal addressing. 

• Answering. 

• Message receiving. 

• Dynamic buffering. 

• Message transmitting. 

• Dialing. 

• Communications system status changing. 

The BTAM user is responsible for: 

• Providing communications system speci- 
fications. 

• Analyzing messages to determine the 
processing programs required. 

• Writing message processing programs for 
specific applications. 

• Writing message processing programs for 
changing communications system status. 

• Routing messages to the appropriate 
processing program. 

• Providing error checking and error cor- 
rections. 

• Providing other message handling func- 
tions such as code translating, time 
and date stamping, header analysis, and 
error checking. 



All lines and their associated terminal 
devices have the same terminal control 
characteristics . 

All lines share the same buffer pool if 
one is used. 

All lines use the same buffering tech- 
nique. (Refer to the publication IBM 
system/360 Operating System: Data Man- 
agement . ) 



The user must supply a DD statement that 
indicates which communications lines con- 
stitute a communications line group and the 
order in which they are to be associated 
with the data control block for the line 
group. 



To create a data control block for a 
communications line group, the user must 
issue a DCB macro-instruction. Before any 
messages can be sent or received over a 
communications line of the group, however, 
the line group must be activated by execu- 
tion of an OPEN macro-instruction. When 
all operations on the lines have been 
completed, the lines are deactivated by 
issuing a CLOSE macro-instruction. 



The DCB, OPEN, and CLOSE macro- 
instructions provide the user with a 
convenient method of specifying, initiat- 
ing, and terminating his communications 
control system. 



Data Control Block (DCB) Macro-Instruction 



TELECOMMUNICATIONS SYSTEM SPECIFICATIONS 



A user must provide certain system 
specifications through the use of macro- 
instructions which cause the following: 

• Creation of system control information. 

• Preparation of control units and 
communications lines for message trans- 
mission. 

• Deactivation of communications lines. 



The DCB macro-instr action causes the 
creation of a data control block. A data 
control block is required for each communi- 
cations line group. This macro-instruction 
reserves space for the data control block 
and assigns values to tbose fields for 
which the user provides parameters. 



r t t 1 

| Name | Ooerati on | Operand | 

h 1 + H 

| dcbname | DCB | keyword parameters | 
L -L ± J 



One data control block must be created 
for each communications line group. A line 
group is a group of communications lines 
that meet the following operational 
requirements: 



dcbname 

Represents the symbolic name of the 
data control block being created. 
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keyword parameters 

Indicate the parameters listed in 
Table 14. When an alternate source 
code is shown with a parameter, it 
indicates the other sources of infor- 
mation that concern the parameter: C 
indicates that the parameter may be 



specified in a DD statement; E indicates 
the parameter whose value may be supplied 
at any time up to and including the DCB 
exit provided at open time. (Refer to the 

publication IBM System/360 Operating S 

Control Program Services . ) 



Table 14. DCB 

r 



Macro-Instruction Keyword Parameters 



T T 

Alternate 

Source 

Code 



Keyword 
Parameter 



Description 



DDNAME=name 



name 



Specifies the name that appears in the DD statement 
associated with the data control block. (Refer to the 
publication IBM Systeiti/360 Operating System: Job Control 
Language . ) 



DSORG=CX 



CX 



identifies the data set organization to 
communications line group. 



that of 



(MACRF=(R) 
<MACRF=(W) 
(mACRF=(R,W) 



(R), (W), or (R,W) 

Specifies that the access to this cortimuni cations line 
group is to be gained through the READ or WRITE 
macro-instructions . 



[BUFNO=n] 



C,E 



Specifies the number of buffers to be provided 
buffer pool. The maximum value of n is 255. 



for the 



[BUFL=1] 



C r E 



Specifies the length (in bytes) of each buffer provided 
for the buffer pool or a standard length for user- 
provided buffers. The maximum value of 1 is 32,767 
bytes . 



+- 



[BUFCB=addr] 



addr 



Specifies the name of a buffer pool control block to be 
provided at assembly time by the user. If this parame- 
ter is not provided, and if both BUFNO and BUFL are 
provided, an OPEN macro- instruction provides a buffer 
pool. 



[BFTEK=D] 



C r E 



Specifies that dynamic buffer allocation is to be 
provided. If this parameter is not provided, it is 
assumed that the user will handle buffering. 



[EXLST=addr] 



addr 



Specifies the symbolic address of the exit list. (Refer 
to the publication IBM System/360 Operating System: 



Control Program Services . ) 



Basic Telecommunications Access Method 
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OPEN Macro- Instruction 



The OPEN macro-instruction prepares 
communications line groups for use. Each 
line group must be opened before message 
transmission can begin. The OPEN macro- 
instruction, together with the CLOSE macro- 
instruction, can be used to control the 
operative or nonoperative status of 
communications lines in the system. 



r t t 1 

| Name | Operation! Operand | 

|. + + H 

| [name] | OPEN | (dcbname if , . . . dcbname n ) 

i i iffMF=L r 

I J |L\mf=(E, listname)/ 

L JL J.Jr 



dcbname ir , . - . dcbnamen 

Specifies the address of the data 
control block associated with a com- 
munications line group to be initia- 
ted. This address may be specified as 
an absolute address, explicit effec- 
tive address* or a parenthesized sym- 
bolic name or integer designating a 
register that contains the address. 

MF=L 

Specifies that this macro-instruction 
results in the creation of a parameter 
list as specified in the operand. 
This form of OPEN macro-instruction 
does not result in the execution of 
the open function. The name assigned 
to the parameter list is the name 
specified in the name field of the 
OPEN macro- instruction. 

MF= ( E # listname) 

Specifies that this macro- instruction 
results in the execution of the func- 
tion. The parameter list constructed 
prior to the issuance of this macro- 
instruction is obtained and the 
function is executed for each parame- 
ter in the list (listname is the name 
assigned to the parameter list) . 

Note: The absence of the MF keyword param- 
eter causes the macro-instruction to be 
executed with all the parameters specified 
in this issuance of the instruction. (For 
additional information, refer to the publi- 
cation IBM System/360 Operating System: 
Control Program Services . ) 



WAIT and WAITR Macro-Instructions 



Two macro- instructions are available for 
signaling that the BTAM problem program can 
relinquish control of the Central Process- 



ing Unit; control can be relinquished 
because the program must wait for the 
occurrence of an event (e.g. , completion of 
an input/output operation) . The two macro- 
instructions are WAIT and WAITR. 



WAIT results in the suspension of 
processing in the task from which the 
instruction is issued; processing resumes 
after the indicated event (s) occurs. The 
WAITR macro-instruction, in addition to 
performing the same functions as WAIT, 
provides two control features. 



The type of control feature implemented 
by WAITR depends on the type of system 
used. In a system with the shared dynamic 
storage option (two job steps alternately 
occupy a single area of core storage) , 
issuance of the WAITR macro-instruction in 
the BTAM problem program results in the 
writing (or "rolling out") of a portion of 
this task on an auxiliary storage device. 
A non-BTAM task (background task) is read 
into core storage (that is, "rolled in") , 
and processing of this task begins. If the 
event for which the BTAM problem program is 
waiting occurs, and the background task has 
no I/O in progress, the background task is 
written on the auxiliary storage device and 
the BTAM task is read back into core 
storage. If the event for which the BTAM 
problem program is waiting occurs, and the 
background task has I/O in progress, the 
BTAM problem program is not read back into 
core storage until the background-task 
event occurs. The BTAM problem program 
should not issue a WAITR macro-instruction 
unless all events for which it has issued 
WAITs have been completed. 



In a system in which the available core 
storage is divided into distinct sections 
(partitions) to concurrently process job 
steps, the first issuance of the WAITR 
macro- instruction from the BTAM problem 
program has the following effects: 1) the 
partition in which the BTAM problem program 
resides becomes permanently assigned to 
BTAM; and 2) a processing program for a job 
step in another job is read into the other 
(or next) partition and processing of that 
job step commences. To use the partition 
technique, core storage size must be great- 
er than 32,768 bytes. Under this parti- 
tioned dynamic storage option, no portion 
of the BTAM task is written out to provide 
more space. As in the case of the shared 
dynamic storage option, however, occurrence 
of an event for which the BTAM problem 
program is waiting signals that control is 
to be returned to the BTAM program. Subse- 
quent issuance of WAITR by the BTAM problem 
program is treated as a WAIT. 
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r t t 

| Name | Operation! Operand 
|. 1 + . 



r t t 

| Name | Operation! Operand 



[symbol] | fWAIT "1 
|\WAITRJ 



1 

n 

(0) 



ECB=faddrx\ 
I (1)/ 

ECBLIST= faddry] 



/addr 
\ (1) 




symbol 

Specifies the name for the WAIT or 
WAITR macro-instruction. 



specifies the number of events that 
must occur before the problem program 
issuing the WAIT or WAITR macro- 
instruction can regain control of the 
system. If (0) is specified, the 
number of events must be loaded into 
register prior to execution of this 
macro- instruction. If no entry is 
made for the number of events, 1 is 
assumed. 



addrx 



Specifies the address of an event 
control block (ECB) representing the 
only event that must occur before 
processing can continue. If ECB=addrx 
is specified, n cannot be greater than 
1. If ECB=(1) is specified, the 
address of the ECB must be loaded into 
register 1 prior to execution of this 
macro- instruction. 



addry 



Specifies the address of a variable- 
length list that can contain the 
addresses of up to 255 event control 
blocks; each event control block rep- 
resents an event to be waited for. 
The WAIT or WAITR macro-instruction is 
satisfied when the number of events 
posted to ECB's specified in the list 
equals the number indicated by the n 
entry in the macro. If ECBLIST=(1) is 
specified, the list address must be 
loaded into register 1 prior to the 
execution of this macro-instruction. 
(For additional information, see the 
publication ^Control Program Services .) 



CLOSE Macro-Instruction 



The CLOSE macro- instruction removes com- 
munications line groups from use. The 
CLOSE macro-instruction can be used with 
the OPEN macro- instruction to control the 
operative status of communications lines in 
the system. 



dcbname 1# , . . .dcbname n 

Specifies the address of the data 
control block associated with a com- 
munications line group to be closed. 
This address may be specified as an 
absolute address, explicit effective 
address, or a parenthesized symbolic 
name or integer designating a register 
that contains the address. 



MF=L 



Specifies that this macro-instruction 
results in the creation of a parameter 
list as specified in the operand. 
This form of CLOSE macro-instruction 
does not result in the execution of 
the close function. The name assigned 
to the parameter list is the name 
specified in the name field of the 
CLOSE macro-instruction. 



MF= (E, listname) 

Specifies that 
results in the 
function. The 
structed prior 
macro- ins tructi 
function is exe 
ter in the lis 
assigned to the 



this macro-instruction 
execution of the close 
parameter list con- 
to the issuance of this 
on is obtained and the 
cuted for each parame- 
t (listname is the name 
parameter list) . 



Note: The absence of the MF keyword param- 
eter causes the macro-instruction to be 
executed with all the parameters specified 
in this issuance of the instruction. (For 
additional information, refer to the publi- 
cation IBM Operating System/360 Operating 
System: Control Program Services . ) 



MESSAGE CONTROL 



The message control section of BTAM 
polls terminals, answers calling devices, 
addresses terminals, transmits and receives 
messages, and dials devices. To use the 
facilities provided by BTAM, the user must 
provide terminal lists. (Refer to 
"Terminal List Structures.") 

Programming for any additional message 
handling, such as code translating, message 
editing, format checking, and routing, must 
also be provided by the user. The number 
of data event control blocks (DECBs) that 
must be defined is equal to the maximum 
number of reads and/or writes that can be 
occurring simultaneously. 
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The format of the data event control 
block is shown in Figure 16. 



Byte , 







Standard ECB 



h 



Length 



4 | Operation Type | 

|. x 

8 | DCB Address 
(. 

12 | Area Address 

(. 

16 | Error Information Field Address 
h 

20 | Terminal List Address 

j. T 

24 | Relative Line No. | Response Field 
L j. 



— i 

~»l 

I I 

HI 
II 

HI 
II 

HI 
I I 

HI 



M 



Figure 16. Data Event Control Block Format 



POLLING 



Macro- instructions for input operations 
are provided by BTAM. The user must pro- 
vide polling lists that determine the order 
in which terminals on each line are inter- 
rogated for messages. (Refer to "Direct 
Polling and Addressing Lists.") The list is 
processed sequentially by BTAM, starting at 
the point specified by the user in his 
problem program. 

Each terminal on the list is polled by 
BTAM. If a terminal has a message to send, 
contact is maintained until either an end- 
of-transmission (EOT) or an end-of-block 
(EOB) character is received. When one of 
these characters is received, completion is 
indicated by ETAM in the line DECB. 

If a terminal has no message to send, 
the next terminal in the polling list is 
polled. Polling continues until a message 
is received, the polling list is exhausted, 
or an error condition is detected. To 
initiate polling, a user must issue a READ 
macro- instruction. 



READ Macro- Instruction 



The READ macro- instruction causes 
contact to be established with a terminal. 
If the terminal has a message to send, 
contact is maintained until an EOT or EOB 
character is received. The READ macro- 
instruction is then considered satisfied 
and completion is posted in the appropriate 
line DECB. 



r t 

| Operation | Operand 
,. + 




decbname,-^ 



r T1 ^ 

TIR 
TT 
TTR 
TV 
TVR 
vTP 



/•, dcbname ,/ area! , 



{: 



f length"!, termli st, rln,fMF=L "\ 
\S J < MF=E > 

[blankj 



decbname 

Specifies the address of the DECB in 
which completion is to be posted. 



TI 



TIR 



TT 



TTR 



TV 



TVR 



TP 



Specifies initial READ. This option 
indicates that initial contacts must 
be made with the terminal. If 
required, contact is made by dialing 
or answering. Otherwise, initial con- 
tact is made by polling. 



Specifies initial READ with RESET at 
completion. (Refer to the "RESET 
Macro- Instruction. " ) 



Specifies continued READ. This option 
indicates that a read operation is 
continued. When an EOB is transmitted 
as a message delimiter, the central 
processing unit must respond to the 
longitudinal redundancy check genera- 
ted by the control unit before trans- 
mission can be continued. This option 
allows BTAM to provide the response 
and to maintain contact with the send- 
ing device, thus eliminating the need 
for repolling. 



Specifies continued READ with RESET at 
completion. 



Specifies conversational READ. This 
option applies to dialing or common 
carrier TWX. Initial contact is made 
by dialing or answering. This option 
makes it possible to hold the line for 
subsequent communication without re- 
establishing contact. 



Specifies conversational 
RESET at completion. 



READ 



with 



Specifies repeat READ. This option 
can be used for terminals that can 
recognize negative responses to be 
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transmitted to the terminal. It 
provides the problem program with the 
means of requesting retransmission of 
data received in error. To accept the 
erroneous data, a continued READ 
macro- instruction can be used. 



MF=L 



Specifies that this macro-instruction 
results in the creation of a parameter 
list as specified in the operand. 
This form of macro-instruction does 
not result in the execution of the 
read function. 



dcbname 

Specifies the address of 
control block for the line. 



MF=E 



the data 



area 



Represents the address of the first 
byte of the input area used to receive 
the message. 



Specifies that BTAM will 
buffer. 



length 

Indicates the number of bytes in the 
input area used to receive the mes- 
sage. 



Indicates that BTAM will provide the 
buffer length specified in the data 
control block. 

termlist 

Indicates the address of an entry in 
the terminal list. 



Specifies that this macro-instruction 
results in the execution of the func- 
tion without the creation of a parame- 
ter list. The parameter list created 
prior to the issuance of this macro- 
instruction will be updated by 
inserting any parameters preceding the 
MF parameter. 



provide the blank 



Specifies that this parameter may be 
left blank. If this parameter is 
omitted, the macro-instruction results 
in the creation of a parameter list 
and the execution of the function. 

Note: For additional information, refer to 
the description of the "L" and "E" forms of 
macro- instructions found in the introduc- 
tion to IBM System/360 Operating System: 
Control Program Services . Table 15 shows 
the operands permitted for each of these 
additional forms and their restrictions. 



rln 



Specifies the relative line number 
(within a line group for the data 
control block referred to) to which 
this macro- instruction applies. 



ADDRESSING 



A convenient method is provided by BTAM 
for directing output messages to a terminal 



Table 15 
r 



READ Macro-Instruction Forms 



Macro- Instruction Form 



Parameter 



|L 



E 



| Neither L nor E 
+ 

Required. 



Required. 
Required. 

Required. 

Required. 

Required. 

Acceptable. 

Not acceptable, 



decb | Must be stated , will 
J be used as the 
j name of the decb, or 
J must not be in 
j register notation. 

type | Required. 

dcbname j Must not be in 

j register notation. 

area j Must not be in 

j register notation. 

length |Must not be in 

j register notation. 

termlist |Must not be in 

| register notation. 

rln j Must not be in 

j register notation. 

MF= |MF=L. 
J. 



Must be stated, will be 
used as a pointer to 
the decb. 



Acceptable, will override. 

Acceptable, will override. 

Acceptable, will override. 

Acceptable, will override. 

Acceptable, will override. 

Acceptable, will override. 

MF=E. 



Note: 



Type represents one of the following options: TI, TIR, TT, TTR, TV, TVR, TP. 
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or group of terminals on a line. The 
terminals to be addressed must be identi- 
fied in an addressing list provided by the 
user. This list may contain the addresses 
of one or more of the terminals on a line. 



All terminals on the specified address- 
ing list are addressed by BTAM before a 
message is sent. To initiate addressing, a 
user must issue a WRITE macro-instruction. 
When a message is destined for more than 
one line, it must be transmitted by separ- 
ate WRITE macro- instruct ions. 



WRITE Macro-Instruction 



The WRITE macro- instruction causes 
transmission of a message segment to the 
terminals specified in an addressing list. 
The list may refer to one or more terminals 
on the line. 



r t 

| Operation | Operand 

h + ., 

TI 

TIR 

TT 

TTR >,dcbname, farea 

TV IS 

TVR 

ITB J 
length I , termlist , rln, J MF=L 
S / < MF=E 

^blank 



| WRITE 



decbname,-< 



|{ 



'{ are !} 



L X J 



TTR 



TV 



TVR 



TB 



This option provides for monitoring 
the response and maintaining contact 
with the terminal. 



Specifies continued WRITE 
at completion. 



with RESET 



Specifies conversational WRITE. This 
option applies to dialing or common 
carrier TWX. Initial contact is made 
by dialing or answering. When contact 
with the line has been established, 
this option provides the ability to 
carry on multimessage transmission 
with one or more components without 
redialing. 



Specifies conversational 
RESET at completion. 



WRITE with 



Specifies SPACE signal write. (Refer 
to the "Commands" section in the pub- 
lications: IBM 2701 Data Adapter Unit, 
Principles of Operation , or IBM 2702 
Transmission Control. ) 



dcbname 

Indicates the address of 
control block for the line. 



the data 



area 



Represents the address of the first 
byte of the output area. 



Specifies that BTAM will write a chain 
of buffers. 



decbname 

Indicates the name of the line DECB in 
which completion is to be posted. 



length 

Specifies the number of bytes in the 
output area. 



TI 



TIR 



Specifies initial WRITE. This option 
indicates that initial contact must be 
made with the terminal. If required, 
contact is made by dialing or answer- 
ing. Otherwise, initial contact is 
made by addressing. 



Specifies initial WRITE with RESET at 
completion. (Refer to "Reset 
(RESETPL) Macro-Instruction.") 



Specifies that BTAM will provide the 
length parameter based upon BUFL. 

termlist 

Indicates the address of the terminal 
list. 



rln 



Specifies the relative line number 
(within a line group for the data 
control block referred to) to which 
this macro-instruction is to apply. 



TT 



MF=L 



Specifies continued WRITE. When an 
EOB is transmitted, the control unit 
provides a longitudinal redundancy 
check. The remote terminal must res- 
pond to the longitudinal redundancy 
check before sending can continue. 



Specifies that this macro-instruction 
results in the creation of a parameter 
list as specified in the operand. 
This form of WRITE macro-instruction 
does not result in the execution of 
the write function. 
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MF=E 



Specifies that this macro-instruction 
results in the execution of the func- 
tion without the creation of a parame- 
ter list. The parameter list created 
prior to the issuance of this macro- 
instruction will be updated by 
inserting any parameters preceding the 
MF parameter. 



blank 



Specifies that this parameter may be 
left blank. If this parameter is 
omitted, the macro-instruction results 
in the creation of a parameter list 
and the execution of the function. 



r t 1 

| Operation | Operand | 

h + H 

|RESETPL |dcbname,rln | 

l ± J 

dcbname 

Indicates the address of the data 
control block for the communications 
line group. 



rln 



Specifies the relative line number 
(within the line group for the data 
control block referred to) to whicn 
this macro-instruction applies. 



ANSWERING 



TERMINAL LIST STRUCTURES 



In order for a terminal to dial and 
establish contact with the computer, the 
user must enable the line to transmit 
messages to the system. This may be accom- 
plished by issuing a READ or WRITE macro- 
instruction with the proper terminal list 
specification. Contact with the terminal 
is established by BTAM, and messages are 
received. For subsequent communication 
with the terminal conversational-type READ 
or WRITE macro-instructions car be used. 

The line, which has been enabled, may be 
disabled by issuing a RESETPL macro- 
instruction or a CNTRL (disable) macro- 
instruction. A line may also be disabled 
by issuing a READ or WRITE macro- 
instruction that specifies a RESET at 
completion. 



The data transmission macro-instructions 
(READ or WRITE) provided by BTAM refer to 
the user-provided terminal list. The 
structure of the list is determined by both 
the terminal equipment involved and the 
type of operation to be performed. In all 
macro-instructions used to generate termi- 
nal lists, component addressing, polling, 
and identification characters must be spec- 
ified as the hexadecimal equivalents of the 
particular terminal device code for that 
character. Tables of the various code 
structures are contained in the publication 
IBM 2701 Data Adapter Unit, Principles of 
Operation , Form A22-6864. 



Direct Polling and Addressing Lists 



Reset (RESETPL) Macro-Instruction 



The RESETPL macro-instruction provides 
the ability to free a dial-type line or to 
interrupt a polling sequence. If a message 
is being transmitted when a RESETPL macro- 
instruction is issued, no action is taken. 
Otherwise, the line is freed or polling is 
interrupted and the preceding READ or WRITE 
macro-instruction is posted as complete. 
Control is then returned to the problem 
program. 

If TIR, TTR, or TVR options of the READ 
or WRITE macro-instructions are specified, 
the reset function will be performed at the 
end of message transmission. If, however, 
the RESETPL macro-instruction is issued for 
a dial-type line which is being polled, the 
polling will be terminated and the line 
will be freed. 



Direct polling and addressing apply to 
data transmission operations where the line 
connection is permanently established 
(non-dial) . Read operations involve the 
polling of terminals. When a READ macro- 
instruction is specified, it must refer to 
a polling list. A polling list determines 
the order in which remote terminals are 
interrogated to send data. 

Write operations require the addressing 
of terminals to prepare them for the 
receipt of a message. When a WRITE macro- 
instruction is specified, it must refer to 
an addressing list. An addressing list 
consists of addresses of one or more 
terminals on a line, which are the destina- 
tions of a message. All terminals in the 
list are contacted before the message is 
transmitted. 

A polling list may be either an open or 
a wrap-around list. An addressing list is 
identical in structure to the open list. 
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OPEN LIST; In an open list, each entry is 
assigned a fixed field size. An index, 
consisting of three procedure flags plus an 
identification number that indicates the 
entry" s relative position in the list, is 
entered for each entry. 



Component 



-End of List 
r Skip 



I 



Format 



- T t 

| ID No. | 
.X J 



v_ 



-> 



Procedure Flags 



entries. When the skip bit is 1 as in 
entries 2 and 3, it indicates that the 
entry is to be deleted from the polling 
sequence. The format bit is 1 in entry 5, 
indicating that the contents of the next 
two bytes are used to locate the start of 
the list. Thus, the polling sequence can 
continue without problem program 
intervention when no terminal responds with 
a message. 



Note: 



If 



in entry 5 the format bit was 
and the end of list bit was 1, the list 
would be an open list and polling would 
cease after entry 5. An addressing list 
would contain addressing characters rather 
than polling characters. 



The last entry in the list has a flag in 
the index. The open list is processed 
sequentially and completion is posted by 
BTAM either when the end of a list has been 
reached, a message has been received, or an 
error condition has been detected. 

WRAP-AROUND LIST; A wrap-around list is 
identical to the open list, except that the 
last entry contains a pointer to the begin- 
ning of the list. Completion of the wrap- 
around list is posted by BTAM when a 
message has been received or when an error 
condition has been detected. When the end 
of a wrap-around list has been reached, 
polling automatically restarts with the 
first entry on the list. To free a line 
during a wrap-around polling sequence, a 
RESET macro-instruction must be issued. 

Figure 17 is an example of a wrap-around 
polling list. The entry for each terminal 
contains two polling characters, and a 
control byte. The polling characters for 
entries 1 through 5 are, in IBM 1050 code, 
A0, E0, CO, DO, and E0, respectively; these 
are represented in Figure 17 in their 
hexadecimal equivalents. The end-of-list 
bit in the control byte is in all 



Dialing and Answering Lists 



Dialing and answering apply where the 
line connection must be established (by 
dialing) before data transmission can take 
place. 

Read operations involve: 

• Dialing from computer to terminal (and 
polling) to receive a message. (In a 
TWX application, terminal identifi- 
cation verification must also be per- 
formed. ) 

• Answering a call from a terminal that 
has dialed the computer and polling the 
terminal to receive a message. (In a 
TWX application, terminal identifi- 
cation verification must also be per- 
formed.) 

When this type of READ macro-instruction 
is specified, it must refer to an appropri- 
ate terminal list. 

Figure 18 is an example of a terminal 
list for dialing from computer to terminal 



| Polling 

I Characters | List 

j. T + 

Entry 1 j E2 j 15 j 
Entry 2 j E4 j 15 | 



| Control Byte 

h t t T 

j End of 

Skip | Format 
+ 

| 
+ 

1 I 



Entry 3 | E7 



h 



Entry H | E8 



Entry 5 



h 



15 | 

4 +- 

I 15 | 



EB 



1 15 | 
X X. 






1 

Relative | 
Location j 

H 

00000 i 

-, 

00001 I 



00010 i 

., 

00011 I 



00100 



I Start of List | 
j J 



Figure 17. Wrap- Around Polling List Example 
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(and addressing) to transmit a message. 
The dial digits may be followed by one or 
more open list entries. The component 
address is shown as the hexadecimal equi- 
valent of IBM 1050 code characters A9. 

Figure 19 is an example of a terminal 
list for answering a call from a terminal 
that has dialed the computer, and polling 
the terminal to receive a message. The 
answer digit (zero) may be followed by one 
or more open list entries. The component 
address is shown as the hexadecimal equiva- 
lent of IBM 1050 code characters A0. 

Figure 20 is an example of a terminal 
list for dialing in a TWX application. The 
terminal identification is shown as the 
hexadecimal equivalent of the Eight-Bit 
Data Interchange Code Characters CHI. 

Figure 21 is an example of a terminal 
list for answering in a TWX application, 
except the answer digit (zero) is added, 
and the number of dial digits and the dial 
digits are not included. The terminal 
identification is shown as the hexadecimal 



equivalent of the Eight-Bit Data Inter- 
change Code Characters CHI. 



Write operations involve: 

• Dialing from computer to terminal (and 
addressing) to transmit a message. (In 
a TWX application, terminal identifi- 
cation verification must also be per- 
formed. ) 

• Answering a call from a terminal that 
nas dialed the computer and asking the 
terminal to transmit a message. (In a 
TWX application, terminal identifi- 
cation verification must also be per- 
formed. ) 



Note: The list structure for the write 
operation is identical to that for the read 
operation except that in the examples 
shown, the field called component address 
contains addressing characters instead of 
polling characters. 



Open List Entry 



r T T T T 1 

| | | Component | Procedure | | 

| No. of Dial Digits |Dial Digits | Address | Flags | Entry ID | 
j. + x + x ., 

| 7 | 4635514 | E213 | | | 

L X X X L J 

Figure 18 . Dial DIALST Example 

Open List Entry 

r ^ -\ 

r t t t 1 

I j I Procedure | | 

I Answer j Component Address | Flags j Entry ID j 

|. + x x ) 

I | E215 | | | 

L X X X J 

Figure 19. Answer DIALST Example 

r T T T T T T 1 

| No. of | | No. of ID | ID From | ID of I Procedure I Entry I 
JDial Digits j Dial Digits j Characters j Terminal | Terminal j Flags j ID | 
j. x x x x x X ., 

| 7 j 4634414 | 3 j j C31393 | | j 

L X X X X X L J 

Figure 20. Dial IDLST Example 

r t r t t t T 

I I No. of ID | ID From | ID of | Procedure | | 

j Answer j Characters j Terminal j Terminal | Flags j Entry ID| 

J. X X X X X ., 

I I 3 | | C31393 | | | 

L X X X X X J 

Figure 21- Answer IDLST Example 
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Define Terminal List (DFTRMLST) 
Macro- Instruction 



E20B,E40B,E70B, E80B (for A5 , B5 , C5 , 
and D5, respectively, in IBM 1050 
code) . 



The DFTRMLST macro- instruction provides 
the capability for defining a polling or 
addressing list, and entering the physical 
addresses and device specifications into 
the list. 



r r t 

| Name | Operation] Operand 



h 



4- 



| entry | DFTRMLST | [ OPENLST ] 

| I IJwraplstL arg a., 

| | j) DIALST [ 

I I I llDLST J 

L X X 



.argn 



entry 



Represents the symbolic name assigned 
to the beginning of the list. 



OPENLST 

Indicates that the list is to be 
open list structure. 



an 



WRAPLST 

Indicates that the list 
wrap-around list structure. 



is to be a 



DIALST 

Indicates that the list is to be a 
dial or answer list in which verifica- 
tion of the identification of the 
terminal is not required. 



IDLST 



Indicates that the list is to be a 
dial or answer list of TWX terminals; 
therefore, verification of the iden- 
tification of the terminal is 
required. 



Dial or answer list (DIALST entry) : 
for a dial list, arg^ specifies the 
number of dial digits, arg 2 the dial 
digits, and arg 3 through arg n the 
addressing or polling characters. As 
in the open list arguments, the 
addressing or polling characters must 
be specified in hexadecimal. Example: 
arg x through arg* are 
7, 4635514, E207,E202 (arg 3 and arg are 
the hexadecimal representation of A3 
and Al in IBM 1050 code) . For an 
answer list, arg x is a zero, and arg 2 
through arg n (in hexadecimal) are the 
addressing or polling characters. 
Example: arg^ through arg 3 are 
0,E20D,E20B (arg 2 and arg 3 are the 
hexadecimal representation of A6 and 
A5 in IBM 1050 code). 

ID dial or answer list (IDLST entry) : 
for a dial list, arg ± specifies the 
number of dial digits, arg 2 the dial 
digits, arg 3 the number of identifi- 
cation digits, and arg* the identifi- 
cation of the terminal. The identifi- 
cation of the terminal must be the 
hexadecimal equivalent of the particu- 
lar terminal device code for the char- 
acters used. Example: arg x through 
arg* are 7, 4635514, 2, 43CD (arg* is the 
hexadecimal representation of B3 in 
Eight-Bit Data Interchange Code) . For 
an answer list, arg^ is zero, arg 2 the 
number of identification digits, and 
arg 3 the identification of the termi- 
nal (in hexadecimal). Example: arg x 
through arg 3 are 0,2,43CD (arg 3 is the 
hexadecimal representation of B3 in 
Eight-Bit Interchange Code) . 



arg a., .. . ,arg n 

Specify the parameters needed to con- 
struct the terminal lists. The param- 
eters that must be included for each 
type of list are as follows: 

Open list (OPENLST entry) : arg a. 
through arg n indicate the addressing 
or polling characters. The actual 
characters are in the code for the 
particular type of terminal, and must 
be specified in hexadecimal. Example: 
arg a. through arg* are 
E202,E402,E702,E802 (for Al, Bl, CI 
and Dl, respectively, in IBM 1050 
code) . 

Wrap-around list (WRAPLST entry) : arg ± 
through arg n indicate the addressing 
or polling characters. As in the case 
of the open list arguments, the char- 
acters must be specified in hexadeci- 
mal. Example: arg x through arg* are 



Change Terminal Entry (CHGNTRY) 
Macro- Instruction 



The CHGNTRY macro-instruction provides 
the means for deleting or reactivating a 
terminal entry in a polling or addressing 
list without redefining the existing list. 
The list referred to in list ID will be 
located and the entry specified in arg ± 
will be altered to the conditions specified 
in arg 2 . 



r t t 

| Name | Operation | Operand 

|. x x .__. 

| | CHGNTRY | entry, type, arg if 

I I I 

I I l/SKIP -\ 

| J | \ ACTIVATE/ 

L X . X 
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entry 



type 



arg x 



SKIP 



Represents the symbolic name for the 
beginning of the list- It is defined 
using the DFTRMLST macro-instruction. 



Signifies the type of list specified 
in the DFTRMLST macro-instruction used 
to create list. 



Indicates the relative position in the 
list of the entry to be changed. 



Indicates that this entry is to be 
skipped when polling or addressing. 

ACTIVATE 

Indicates that this entry is to be 
reactivated. 



The address of the first byte of the first 
buffer will be contained in the data event 
control block. 

For write operations with dynamic buf- 
fering, the user must provide the address 
of the first byte of the first buffer in 
the line DECB and specify the macro- 
instruction with an area parameter of S. 
The first twelve bytes of each buffer must 
also be in the format shown above. BTAM 
will provide the command codes and 
terminate the operation when all buffers 
have been transmitted. The address fields 
in the last buffer must be null. If the 
address fields of any buffer are non-zero, 
they will be assumed to contain valid 
buffer addresses. 



ERROR HANDLING 



BUFFERING 



When the data control block parameters 
BUFNO and BUFL or BUFCB are provided, a 
buffer pool is shared by all lines in the 
communications line group. The user may 
manipulate the pool using the GETBUF and 
FREEBUF macro-instructions. 

If the data control block parameter 
BFTEK=DYN is also specified, BTAM dynami- 
cally allocates buffers to read operations 
and dynamically writes a chain of buffers. 
The first eight bytes of each buffer con- 
tain the read or write channel command 
word, and the next four bytes contain a 
transfer in channel command. Thus, the 
user's definition of buffers length 
(BUFL=1) must be twelve bytes larger than 
that required for data. 

For read operations with dynamic buffer- 
ing, the user may specify an initial input 
area in the READ macro-instruction. Alter- 
natively, BTAM provides the initial area 
from the buffer pool if an area parameter 
of S is specified. Any additional buffers 
needed will be supplied by BTAM from the 
buffer pool. 

r T T T T T 1 

| Command | Address | | Count | Command | Address | 
| Code |+ 16 of | | j Code jof Next | 
I j Next j | | j Buffer | 
I | Buffer 111 | | 
i j. j. ± j. x j 

1 4 6 8 9 12 



At the end of the read operation, the 
first twelve bytes of each buffer will be 
in the format shown above. For the last 
buffer, the addresses will both be null. 



Error conditions are posted in the line 
error information field by BTAM routines. 
These conditions must be recognized by the 
user to ensure proper operation (Figure 
22). 

An all- zero-sense byte indicates that 
the operation was completed successfully 
and no error conditions occurred. In a 
non- zero- sense byte, the bit positions 
indicate command reject (bit 0) , interven- 
tion required (bit 1), parity error 

(bit 2) , equipment check (bit 3) , data 
check (bit 4) , overrun (bit 5) , receiving 

(bit 6), and time-out (bit 7). (Refer to 
the publications IBM 2701 Data Adapter 
Unit , Principles of Operation and IBM 2702 
Transmission Control . ) 

Completion is posted whether termination 
was caused by a completed transmission or 
by an error condition. The terminal 
response character is placed in the 
response field byte of the data event 
control block and it is the responsibility 
of the user to test these conditions and 
take proper action. 

If successive macro-instructions are 
issued for a line before the preceding 
macro-instruction has been posted as com- 
plete, they are rejected. 

When using dynamic buffer allocation, it 
is the problem programmer's responsibility 
to provide sufficient buffers to accommo- 
date maximum traffic for the system. If 
buffers are requested and none are avail- 
able, no buffer can be assigned. If no 
buffers are available, a null link is 
inserted in the last message buffer. This 
results in an incomplete message transmis- 
sion and the error condition is posted in 
the sense byte of the error information 
field (Figure 22) . 
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The FREEBUF macro-instruction must be 
used to free buffers and return them to the 
buffer pool. Concerning buffer pool usage, 
the first eight bytes of the buffer contain 
the channel command word for this transmis- 
sion, and the next four bytes of the buffer 
contain the linkage to the next buffer for 
this transmission. 



Free Buffer (FREEBUF) Macro-Instruction 



The FREEBUF macro-instruction returns 
the buffer whose address is contained in 
the specified register to the buffer pool 
associated with the specified data control 
block. Buffers assigned using dynamic buf- 
fering must be returned to the pool by the 
problem program. 



Channel Status 
Word 



r T T T T T 

| Sense | | Line DECB Address | | | 
I Byte || III 

L X J. X X X. 

12 ( 



14 15 16 



r t 1 

| Operation | Operand | 

j. 1 -I 

| FREEBUF |dcbname,T | 

L X J 

dcbname 

Specifies the symbolic name of the 
data control block through which the 
buffer was assigned. 



Status 



Figure 22. Line Error Information Field 
Format 



Specifies the register that contains 
the address of the buffer to be freed. 
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APPENDIX A; QUEUED TELECOMMUNICATION ACCESS METHOD SAMPLE PROBLEM 



SYSTEM CONFIGURATION 



The system configuration for the QTAM 
sample problem (Figure 23) is as follows: 



type applications. Message switching 
refers to messages that do not require 
processing of message text but are to be 
routed directly to their destinations. 
Destinations which are specified in the 
input header may be any of the following: 



Communications 



1050 Data Communications System (five) 
Half-Duplex Communications Line (two) 
2701 Data Adapter Unit (one) 
Multiplexor Channel (one) 
2311 Disk Storage Drive (one) 



Operating System 

Computing System/360 Model F30(64k) (one) 
Selector Channel (one) 
1052 Console (one) 

1402 Card Read-Punch (one) 

1403 Printer (one) 

2311 Disk Storage Drive (one) 

The sample program is capable of hand- 
ling message switching and inquiry message 



• Single destination specified in the 
destination field of the header. For 
example; NYC. 

• Multiple destinations specified in 
sequence in the header. For example, 
NYC PHI ... . 

• Distribution list specified in the 
header. For example, PBW would specify 
destinations contained in the terminal 
table list for PBW; i.e., Boston and 
Washington. 

Inquiry message refers to process mes- 
sages that require processing of the mes- 
sage by problem programs resident in the 
central processing system. Reply messages 
must be generated for transmission back to 
the sending terminal. (Refer to Figures 24 
and 25 and to Tables 16 and 17.) 



1052 
Console 



CHI 



BOS 



1050 Data 
Communications System 



1050 Data 
Communications System 



Mutliplexor Channel 



Model F30 
Computing System/360 



Selector Channel 



Half-Duplex 

Communications 

Lines 



2841 

Storage 

Control Unit 



1050 Data 
Communications System 



1050 Data 
Communications System 



1050 Data 
Communications System 



NYC 



PHI 



WAS 



2701 

Data Adapter 

Unit 



CDi 

2311 

Disk 

Storage 



2821 
Control Unit 




1403 
Printer 



1402 Card 
Punch-Reader 



Figure 23. Queued Telecommunications Access Method Sample Problem - System Configuration 
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Switched Message (Input) 
Bytes 12 3 4 5 6 7 



9 10 11 12 13 14 15 16 17 18 19 20 21 22 



92bCHI bNYC bPHI bPBW; * 1 TEXT \\ " © 



Sequence 
Input 



^_ 



Destination 1 Destination 2 Destination 3 T Priority 

EOA 



EOT 



Switched Message (Output) 
Bytes 12 3 4 5 6 7 



9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 



/ 


1 


9 


2 


b 


C 


H 


I 


b 


N 


Y 


C 


b 


P 


H 


I 


b 


p 


B 


W 


; 


b 


1 


1 


• 


3 





• 


4 


5 










/ 




v , ; 






i j 


, , y .... .. 


, * 


r 






Sequence 
Input 


Source Destination 1 Destination 2 Destination 3 I Inpu 

EOA 
30 31 32 33 34 35 36 37 38 39 40 41 42 


t Time Stamp 






b 


6 


4 


• 


2 


8 


5 


* 


1 


b 





8 


3 


TEXT (( 


C 










i a. j 




v. 




i 

















Input Date Stamp Priority Sequence Output 



EOT 



*Blank spacing preceding text must be provided by the problem program to be used for the sequence out, time stamp, and date stamp fields. 
This will be the new start of message. 

L J 

Figure 24. Switched Message Formats 



Processed Message (Input) 
Bytes 1 23 45 67 8 9 10 11 12 



Bytes 



2 1 _3_ b _C_ H _I b_ C__P U ; TEXT \( © 



Sequence 
Input 



-^^ 



Source 



Destination EOA 



EOT 



Processed Message (Output) 
1 2 3 4 5 6 7 8 9- 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 



r 


P 


b 


2 


1 


3 


b 


1 


1 


5 


b 


C 


H 


I 


b 


1 


3 


• 


1 


1 


• 1 


3 


b 


6 


4 


• 


2 


8 


5 



S-' V v 

""Message *Sequence 
Type Input 



*Sequence *Destination 

Output 



**Output Time Stamp 



'Output Date Stamp 



TEXT 



I 



© 



EOT 



Reply Generated by Message ' 
Processing Program 
•"Inserted by problem program. 

*Blank spacing preceding text must be provided by the problem program to be used for the sequence out, time stamp, and date stamp fields. 
This will be the new start of message. 



L_. 



Figure 25. Processed Message Formats 
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Table 16. Message Control Sample Problem 
r 



T T 

Name | Operation! Operand 
x x 



Comments 



Define DCB for Communications Line Group 



DCBGROUP JDCB 
I 



DDNAME=DDGROUPl 



Gives the DDNAME associated with the data 
control block. 



|DSORG=CX, 



Defines the data control block as a 
communications line group type. 



+- 



I— 



|MACRF=(G,P) , 



Indicates that GET and PUT macro- 
instructions will be used to refer to 
this data set. 



|BUFRQ=3 f 



Specifies the number of buffers to be 
requested in advance for each line. 



CPRI=E, 



Gives send and receive equal priority. 



CP0LL=(P0LLINE1, 
POLLINE2) 



Represents the symbolic names assigned to 
polling lists for each line. 



-+- 



CLPS=LPS1 



Identifies LPS1 as the name of this line 
group LPS . 



ACL0C=13 



Indicates the relative address of the 
device in the terminal entries. 



Define DCB Direct-Access Queues 



QUEUE I DCB 



DDNAME=DDFILE 



Gives the DDNAME associated with the data 
control block. 



j DSORG=CQ 



Defines data control block as a direct- 
access device type. 



4- 



MACRF=(G,P) 



Indicates that GET and PUT macro- 
instructions will be used to refer to 
this data set. 



J. JL 

Define Terminal Table 



_ T T 

I TERMTBL I CPU 



Specifies the extent of the terminal 
table; CPU is defined as the last entry 
in the terminal table. 



+ + 

LIMIT | OPTION j FL1 



■+- 



4- 



4 



LIMIT is the symbolic name of the field 
in this terminal table that contains the 
limit of consecutive polls for each 
terminal. Field length equals one (FL1) . 



CHI 


| TERM 


NYC 


|TERM 


PHI 


|TERM 


BOS 


|TERM 


WAS 


ITERM 



| L, DCBGROUP, 1,E407E40D, (2) 
| L, DCBGROUP, 2, E207E20D, (2) 
|L, DCBGROUP, 2, E407E4 0D, (2) 
| L, DCBGROUP, 1,E207E20D, (1) 
| L, DCBGROUP, 2, E707E70D, (1) 



The five terminals and their parameters 
are entered in the terminal table. The 
explanation of the first line is as 
follows: L indicates that the outgoing 
messages are to be queued by line. 
DCBGROUP specifies the name of the data 
control block. 1 is the relative line 
number within the line group to which the 
terminal is attached. E40DE407 is the 
hexadecimal representation of IBM 1050 
code- characters B6 and B3; B6 is the 
polling code and B3 the addressing code. 
2 is the maximum number of continuous 
polls to be inserted in the field LIMIT 
defined above. 

(continued) 
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Tatle 16. Message Control Sample Problem 



■t t 

| Operation | Operand 



(continued) 
_ T 



Name 



Comments 



h- 



4 

J LIST 



■I- 



PBW 



(BOS, WAS) 



j Defines a distribution list of message des- 
tinations as Boston and Washington- 



-+ +- 

I PROCESS I 



CPU 



J. X. 

Define Polling Order 



j Defines symbolic name of a process data 
j control block in the terminal table. Allows 
| CPU as valid destination. 

.x 



t t 

POLLINEj. | POLL | (CHI, EOS) 
I I 



| Defines order of polling of terminals 
j attached to line 1. Identifies terminals. 



4- 



POLLINE 2 I POLL I (NYC, PHI, NYC, WAS) 
J. J. 



I Defines order of polling of line 2. 

.x . 



Define Buffering 



| BUFFER | QUEUE, 60, 125 | Provides main storage buffer areas for the 
j j j data set (QUEUE) used for message queueing. 
j j j Sixty buffers are specified, 125 bytes per 
| | j buffer. 

X _ X X 


Define Beginning of Message Control Task 


T T ~ T "~ 

STQTAM |OPEN | (QUEUE, , DCBGROUP) j Initializes the data control blocks for the 
j j j data set to be used for message queueing and 
j j j the communications line group. It causes 
j j j polling to be initiated on the lines, and 
| | j updating of queue status tables . 
XX x — 


T T T 

| ENDREADY | | Specif ies the end of the initialization 
j j j instructions. 

X X X 

LPS1 |LPSTART | 20 | Identifies start of message segment; 20 
j j j spaces for the time stamp, date stamp, and 
j j j sequence out number. 

X X X 

1 RCVSEG | (Instructions following will service header 
j j | and text segments of the input message. 
— 1 X X 


t T T 

| TRANS |RCVE1050 | Converts 1050 message characters to EBCDIC 
j j j (for all segments, header and text) . 

X X X 

1 RCVHDR | | Instructions following will service the 
j j j header segment of the input message, 
x — — X x - 


T T T 

| SKIP |»C',' | Causes all characters up to and including 
j j |the , to be skipped. 

X X X 

1 SEQIN |3 | Checks sequence of numbered messages for 
j j j each terminal as they arrive. Operand is 
j j jthe number of characters in header sequence 
| | | number field. 

X X X 

| SOURCE 1 3 | Checks the validity of the source terminal 
j j j code received in the message header against 
j | jthe terminal table provided by the user. 
| j j The operand specifies the number of charac- 
j j j ters in the source field of the header. If 
j j j invalid an error is indicated in the error 
j j | half-word. 



(continued) 
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Table 16 

r 

I Name 



Message Control Sample Problem (continued) 

T 



- T T 

| Operation | Operand 



h 



Comments 



4 



ROUTE 



+" 



Checks the validity of the destination code 
in the message header. If the destination 
code is valid the message is subsequently 
queued for the specified destination. Oper- 
and specifies the number of characters in 
the destination code. 



EOA 



C; 



Causes messages to be routed to any addi- 
tional destination. Operand identifies; as 
the end of address character. This charac- 
ter must appear in the message header after 
the last destination code. 



TIMESTMP 



Inserts the time-of-day stamp in the header 
field. First character is blank. Operand 
indicates number of characters to be insert- 
ed. 



+- 



DATESTMP 



Inserts date. (See TIMESTMP.) 



MODE 



PRIORITY, C** 



If next character is an * then the character 
following will be the priority. 



ENDRCVE 



Specifies that following macro-instructions 
will service the message after the end of 
message is received. 



EOBLC 



Allows the 1050 Data Communications System 
to continue receiving after an end-of-block. 
It also provides a procedure for line cor- 
rection if a transmission error is detected. 
If the error is not corrected, an error is 
indicated in the error half-word for this 
line. 



4 



ERP.MSG 



=X'3000' , SOURCE, =C ' S 
MESSAGE NUMBER 
NOT IN SEQUENCE* 



Sends the error text to the specified ter- 
minal when error type specified by the mask 
is detected. The message header will 
replace the 6. The mask is the bit configu- 
ration (in hexadecimal) used to test the 
half-word error indicator. 



4- 



ERRMSG 



=X ' 8600 ' , SOURCE, =C ' S 

MESSAGE NUMBER 

IN ERROR CORRECT AND 

RESEND' 



Sends message on detection 
cated by error mask X'8600'. 



of error indi- 



CANCELM 



X'8600' 



Specifies that any message mask X'8600 is 
canceled. 



POLLIMIT 



LIMIT 



Determines whether the terminal has sent the 
maximum number of messages allowed on a 
single polling pass. Operand is the symbol- 
ic name of a field in the terminal table 
which contains the limit of consecutive 
polls for each terminal. 

(continued) 
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Table 16. Message Control Sample Problem (continued) 



_ T T 

| Operation | Operand 



Name 



h 



Comments 



H 



POSTRCVE 



Indicates 
the LPS. 



the end of the input section of 



SENDHDR 



Specifies that following macro-instructions 
will service the header segment of the 
output message. 



MSGTYPE 



=C'P' 



Determin 

message. 

a P, the 

message. 

spaces 

the out 

number. 



es if the message is a type P 

If the next nonblank character is 

following LPS group will handle the 

The problem program must leave 20 

at the beginning of the message for 

time stamp, date stamp, and sequence 



SKIP 



Skips sequence input number. 



SECOUT 



Sequenti 
nation a 
ber plus 
must be 
problem 



Before: 



ally numbers outgoing message desti- 
ddress. A 3-character sequence num- 
a leading blank is inserted. Space 
reserved at the beginning by the 
program. 



After: 






1 












19 


20 21 


22 


23 24 25 


26 


27 28 29 




b 


b 


-If- 


b 




P 


b 


2 


1 


3 


b 


C 


H 


1 


TEXT 


1 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 


b 


b 


.. 


b 




P 


b 


2 


1 


3 


b 


1 


1 


5 


b 


c 


H 


1 


TEXT 



SKIP 



+" 



Skips destination field. 



TIMESTMP 



Inserts a 6-character time-of-day stamp in 
the outgoing header field plus a leading 
blank. (See SEQOUT operand.) 



Eefore:> 






1 




6 


7 


8 


9 


10 


11 


12 


13 


14 


15 16 


17 


18 


19 


20 21 


b 


b 




b 


, 


P 


b 


2 


1 


3 


b 


1 


1 


5 


b 


C 


H 


1 


> 



22 23 24 25 26 27 28 29 



After : ( 



>, 


3 1 • 1 1 


1 




1 


3 


TEXT 



DATESTMP 



Inserts a 5-character date stamp in the 
message. 

Before: o 1 2 3 4 5 6 7 8 9 10 11 12 13 u 15 16 17 is 19 20 21 



22 23 24 25 26 27 28 29 



After: 



3 b 6 4 "285 TEXT 



(continued) 
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Table 16. Message Control Sample Problem (continued) 



T T 

Name | Operation | Operand 
-+ +- 



Comments 



j. + 1 + ., 



j MSGTYPE j |A11 messages except type P messages v.'ill be 
1 j | handled by the following LPS group. 

1 4. + 

j SEQOUT j 4 j Inserts a 3-character sequence number of 
j j j message plus a leading blank. 

4. 4. + 

j SENDSEG j |Specifies that following macro-instructions 
j j jwill service header and text segments of the 
| j j output message. 

— 4. 4- 4- 


T t T 

j TRANS JSEND1050 (Translates output message using code conver- 
| | jsion table named SEND1050. 

+ + ___ __ + 

j PAUSE j X' 15' , 20X' 17' |Upon recognition of carriage return charac- 

I j jter, this routine inserts 20 idle characters 

II j to provide time for carriage return, 
j j j |l5=carriage return in hexadecimal; 17=IDLE 
jj j in hexadecimal. 

+ 1 _ 1 

j ENDSEND j | Identifies the end of instructions used to 
j j j service output messages. 

j j EOELC j j Allows the 1050 Data Communications System 
jj j to continue sending after receipt of an 
j j j end-of-block. It also provides a procedure 
j j j f or line correction if a transmission error 
ij |is detected. If the error is not corrected 
jj j an error is indicated in the error half-word 
j j | f or this line. 

+ + __ + — 

j REROUTE |=X' 0040' ,=C* BOS* | Causes a message to be queued for the 
j j j j terminal specified when the error type spec- 
| j jified in the mask X'0040' is detected. 

+ + 1 

j POSTSEND j (Identifies the end of the sending portion of 
j j j the LPS. It also indicates the last 
j j (instruction of this LPS. 



L X JL X J 
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Table 17. QTAM Sample Problem Programs 
r 



-t t 

| Operation | Operand 



Name 



Comments 



h 



I- 

LOOP 



STPROCES | OPEN 

I - 

I - 

I • 
X. 



(PROCESSQ) 



j Opens data set that contains the queue of 
| messages to be processed. 



GET 



PROCESS Q,WORKAl 



| Gets the next sequential segment from the 
j queue referred to in the data control block 
| and places it in workarea WORKA1. Message 
j is now available for processing by the 
| problem program. The message is obtained 
| f rom the queue specified by the parameter 
j ddname (CPU). The program would be executed 
j under the normal protection features offered 
j by the control program. Data sets to be 
| used in preparing the reply would be 
j referred to under normal procedures of 
j System/360 Operating System. 



PUT 



[REPLYQ r WORKA2 



j Places the processed message on the 
j appropriate destination queue specified by 
j the DCB parameter TRMAD. The terminal table 
j entry name in location specified by TRMAD 
| will be the destination. 



LOOP 



h 
|( 

h 
\\ 

I. 4— 

W0RKA2 j DS 

I- +— 

SOURCE I DS 



| Gets next message for processing. 
.j. 



Constant Definition 



W0RKA1 



DS 



CL300 



| Provides storage for message processing 



CL300 



j Provides storaqe for message processing. 

. + _ 

| Provides area that will contain the destina- 
tion terminal table entry name. 
.j 



CL3 



DCB Definition PROCESSQ 



PROCESSQ I DCB 



DDNAME=CPU 



(Identifies the name of the process queue 
| terminal table entry and the DDNAME asso- 
| ciated with this process data control block. 





— + 

1 
j. 


X 

| DSORG=MQ 
4. 


+ 

| Defines data control block as process type. 

4. 




T 
1 

1 

X - 


T 

| MACRF=G 

1 

4- - 


T 

| Indicates that the program uses the GET 
j macro-instruction . 
x _ _ 




T 

1 
j. 


t 

| BUFRQ=2 

4. - 


T 

| Indicates two buffers to be queued in core. 
4. _ 




T 

1 

4. 


T 

j RECFM=G 

X — 


T 

| Specifies working unit as a message. 

4. _ 




T 
1 
1 


t 

| SYNAD= ERROR 

1 

4. _ 


T 

| Identifies the name of the routine that will 
j handle overflow messages. 

X _ — 




T 

1 

1 
j. 


T 

| TRMAD=SOURCE 

1 
- — 4. 


T 

(Specifies the name of the location that will 

j contain origin of the message. 
_ i 




T 

1 
4. 


T 

|SOWA=300 
X _ 


T 

(Specifies the workarea size (in bytes). 

x 


Reply 









REPLYQ | DCB | RPYOUT, DSORG=MQ , 
j |MACRF=P,RECFM=G, 

| |TRMAD=SOURCE f SOWA=300 

X X 



| Defines parameters for data control block 
j associated with an output message processing 
| queue. 

-X 
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APPENDIX B: BASIC TEIECOMMUNICATIONS ACCESS METHOD SAMPLE PROBLEM 



SYSTEM CONFIGURATION 



The system configuration for the BTAM 
sample problem (Figure 26) is as follows: 



Selector Channel (one) 
1052 Console (one) 

1402 Card Read-Punch (one) 

1403 Printer (one) 

2311 Disk Storage Drive (one) 



Communications 

1050 Data Communications System (three) 
Half-Duplex Communications Line (one) 
2701 Data Adapter Unit (one) 
Multiplexor Channel (one) 
2311 Disk Storage Drive (one) 

Operating System 

Computing System/360 Model E30 (32K) (one) 



BTAM provides macro-instructions to read 
a message into the computer and to write 
the message cut to a communications device. 

The program presented in Table 18 pro- 
vides an example of the use of BTAM macro- 
instructions to read messages from remote 
terminals as depicted in Figure 26. The 
problem program processes the message and 
sends a reply to the remote terminal on the 
line. 



1052 
Console 



Multiplexor Channel 



Model E30 
Computing System/360 



Selector Channel 



2841 

Storage 

Control Unit 




Half-Duplex 

Communications 

Line 



1050 

Data Communications 

System 



1050 

Data Communications 

System 



1050 

Data Communications 

System 



NYC 



PHI 



WAS 



2701 

Data Adapter 

Unit 



2821 
Control Unit 



1403 
Printer 



1402 Card 
Reader-Punch 



Figure 26. Basic Telecommunications Access Method Sample Problem - System Configuration 
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Table 18. BTAM Sample Problem Programs 



t t 

Name | Operation! Operand 

jl j. 



Comments 



Define Polling List and Data Control Block 



- T T 

JDFTRMLST JOPENLST, 



LINEA 



LINEA specifies the symbolic name of start 
of polling list. OPENLST indicates that the 
polling list is to be an open list 
structure. 



E20B,E40B,E70B 



The first two characters of each operand 
(E2 f E4, E7) are the hexadecimal representa- 
tion of the IBM 1050 code characters (A, B, 
and C, respectively) , identifying the sta- 
tion on the line. The last two characters 
of each operand (OB) are the hexadecimal 
representation of the IBM 1050 code charac- 
ter (5) identifying the component to be 
polled. In this case, the component at each 
station is the 1050 keyboard. 



LINE1 



DCE 



|DDNAME=JOBA, 



Gives the DDNAME to be associated with this 
data control block. 



|DSORG=CX f 
I 



Defines the data organization as that of a 
communications line group. 



|MACRF=(R,W) , 



Specifies user-supplied READ and WRITE 
macro-instructions . 



4 

|BUFNO=10, 
I 



Specifies the number of buffers to be 
assigned to the line. 



BUFL=92, 



Specifies the length of each buffer to be 
provided for the buffer pool. 



BFTEK=D 



H- 



Indicates dynamic buffer allocation. 
Opens the communications line. 



INITIATE | OPEN 
J. 



(LINED 



Problem Program to Read From Line 



LOOP 



READ 



INPA, 



Indicates the name of the data event control 
block. 



4 

|TI, 

I 
I 



Specifies that initial contact with the 
terminal is to be established by the READ 
macro-instruction. 



|LINE1, 



Specifies the name of the data control block 
associated with the communications line. 



S, 



Represents the input area to be provided 
from the message pool by BTAM. 



4— 
IS, 



Indicates the size of the input area to be 
provided by BTAM. 



4 

| LINEA, 



Names the polling list. 



Specifies the relative line number. 



I WAIT 



| ECB=INPA 



Specifies that the user must wait for com- 
pletion to be posted in the block named 
INPA. 

(continued) 
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Table 18. ETAM Sample Problem Programs (continued) 



T T ~ 

Name | Operation | Operand 

_ J. _ X _ _ 


1 


Comments 


B PROC 


Problem Program to Write to Line 


T T 

WRA | WRITE |OUTA, 

1 1 
+ 1 


T 
+- 


Specifies the name of the data event control 
block. 



|TI, 



4- 



Indicates initial contact with the terminal 
is to be established for the WRITE macro- 
instruction. 



|LINE1, 



Specifies the address of the data control 
block for the line. 



(OUTAREA) , 



Represents the name of the register that 
contains the address of the output area. 



(OUTSIZE), 



Represents the name of the register that 
contains the number of bytes in the OUTAREA. 



| (TERMADDR) 



Specifies the name of the register that 
contains the address of the addressing list. 



Specifies the relative line number. 



■+- 



I WAIT 



ECB=OUTA 



Specifies that the user waits for completion 
to be posted in the block named OUTA. 



4 + 

I FREEBUF j LINE1, OUTAREA 



Frees the buffer used for the output 
message. 



Specifies additional processing. 



User-Written Routines to Process Message 

T T 



PROC 



Indicates that the processing of the input 
message is to be performed. The buffer for 
the output message must be obtained by the 
user, but it may be done using the GETBUF 
macro-instruction. 



4 + 

I GETBUF | LINE1, OUTAREA 
I I 



Specifies the address of the data control 
block for the line. OUTAREA indicates the 
name of the register that will contain the 
address of the output buffer. 



Specifies additional processing. 



i -L 

End-of-Job Shutdown of System 



END 



- T 

| CLOSE 
I 



(LINED 



Specifies that when the problem program has 
completed all message processing, it must 
close the communications line. 

(continued) 
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Table 18. BTAM Sample Problem Programs (continued) 



r t t 

| Name | Operation! Operand 

j. x j. 

| Storage and Symbol Definitions 
j. T T 

j OUT A RE A | EQU j 4 
| OUTSIZE | EQU | 6 
|TERNADDR j EQU |7 
j. -^_x_ X 

| Define Addressing Lists 



Comments 



Indicates that the problem program 
define symbolic register names. 



must 



j. T ~.-,— T 

JTERMA JDFTRMLST |OPENLST,Al 
|TERMB |DFTRMLST |OPENLST,Bl 
|TERMC |DFTRMLST |OPENLST,Cl 



Specifies that the appropriate addressing 
list address must be provided in the reg- 
ister named TERMADDR when the WRITE macro- 
instruction is executed. 
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INDEX 



Where more than one page reference is 
listed, the major reference is given first. 

Access key 54 

Access methods application 7 

Activation of communications 

lines 23,48,62 

Addressing 

characters 28,70 

code 28 

list 70-71 

terminals 12-13 

Allocating buffers dynamically (see 

also buffer) 12,63 

Alternate source code 16 

Analysis functions 62 

Answer DIALIST 71-72 

Answer IDLST 71-72 

Answer list argument 72 

Answering 12,62 

Answering lists 70-72 

Application 

access methods 7 

conversational type 12 

data collection „.... 55 

inquiry message 75 

inquiry (or transaction) processing ... 7 

message switching 7,75 

Tele-processing 7 

Assembler language 11,14 

Assembler program - 7 

AT&T Model 33 or 35 Teletypewriter 

Terminal (see Common Carrier TWX Stations) 
AT&T 83B2 Selective Calling Stations . 7,28 

Basic telecommunications access 

method 62-74,7,12,83-86 

Braces, when used 15 

Brackets, when used 15 

Breakoff error 38,43 

BREAKOFF macro-instruction 43,38 

BTAM (Basic Telecommunications Access 

Method) i 62-74,7,12,83-86 

Buffer 12,15,17,73-74,77,78,84 

allocating 7,12,30-31,63,73,84 

areas 78 

assignment 31,43,62 

chains, writing of 12 

formats 32 

insufficient 43 

lengths 7,45 

pool 70,71,81,62,63,74,84 

BUFFER macro- instruction 30-31 

Buffering 30-31,73,13,19,62 

CANCELM macro-instruction '... . 42,43 

Card punch 19 

Carriage return 20,21,41,45,80 

Carriage return-line feed, 

combined 20,21,45,80 

Character code 11,12 

Characters, priority of 12 



CHGNTRY macro-instruction 7 2-73 

CHNGPL macro-instruction 48,25 

CHNGT macro-instruction 49,44,51 

CLOSE macro-instruction 22,24-25,65 

E form 25,65 

L form 25,65 

message control task use 26 

message processing task use 26 

Code 

addressing 28 

alternate source 16 

character 11,12 

conversion tables 12,41,81 

distribution list 26,53 

extended binary-coded decimal 

interchange 26,41 

message type 40 

polling 28 

source terminal 36 

terminal 49,50,26,51,52 

translating 13,14,62,65 

transmission 52 

Collating sequence, standard 12 

Common Carrier TWX 

stations 7,28,48,66,68,70 

Communications 

line group 15-17,11,22-24,31,62-64 

lines, activation of 23,48,62 

lines, deactivation of 48-49,62 

system specifications 6 2 

system status changing 62 

Configuration, system (sample) 75,83 

Continued READ 66 

Continued READ witn RESET 66 

Continued WRITE 6 8 

Continued WRITE with RESET 6 8 

Control 

block (see specific item) 

information 10,11,15,26 

messages 57 

operator 57 

programs 9,10 

unit (see also IBM Data Adapter Unit 

or IEM Transmission Control) 7 

Conventions, used to illustrate coding 

format 15 

Conver sationa 1 mode 39,56 

Conversational READ 6 6 

Conversational READ with RESET 66 

Conversational type application 12 

Conversational WRITE 6 8 

Conversational WRITE with RESET 63 

Conversion tables 12,41,81 

COPYT macro-instruction 49 

CPYPL macro-instruction 47 

CPYQ macro-instruction 54-55 

Data cataloging facilities 10 

Data collection 7,9,10,55 

Data control block 15-22,62-63,23, 

25,45,46,47,48,49,64,66 
Data control block exit 6 3 
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Data definition statement 

(DD statement) 15-21,10,62,63 

Data event control block 66,67,68 

Data management facilities 9,10,13 

Data processing task 9 

Data set 

definition 10,15 

initialization 22, 31 

label . 15 

logging device 23 

organization 17,19,20,21,63 

sequential 19 

termination 22 

Data set initialization macro- 
instructions 31 

Date stamp 38 

Date stamping 13,14,62 

DATESTMP macro- instruction 38,34 

DCB exit 63 

DCE macro-instruction 16-21, 10, 15 

22,23,25,45,46,47,48,49,64,66 

DD statement 15-21,10,62-63 

Deactivation of communications 

lines - 48-49,62 

DECB (data event control block) .. 66,67,68 

Delimiter 33-36 

Delimiter macro- 
instructions 33-36,11,59,60 

Destination code 13,37,38,43,53 

illegal 43 

validating 10 

Destination queue (see output queue) 

Device-address field . 16 

Device allocation information 16 

Device oriented functions 62 

DFTRMLST macro- instruction 72 

Dial DIALST 72 

Dial IDLST 72 

Dial list argument „. 72 

Dialing ". 12,62 

DIALST 

answer 72 

dial 72 

Direct-access device 19,29 

address 47 

Direct-access message queue 16,18,25 

Direct- access 

storage 9-11,14-16,22,23,47 

DIRECT macro- instruction 37-38 

Distribution list 28,29,37,50,53 

DSL (data set label) 15 

Dynamic buffer allocation 12,63,74 

Dynamic buffering 62,73 

EBCDIC (extended binary-coded decimal 

interchange code) 26,41 

ECB 66 

Ellipsis, when used 15 

Enable 69 

End-of-address character 37 

End-of-address macro-instruction 37 

End-of-block character .. 20,21,31,35,39,66 

End-of-block macro- instruction 39 

End-of-transmission 39,58 

End-of-transmission character 

(EOT character) 20,21,44,66 

ENDRCVE macro-instruction 35,34 

ENDREADY macro-instruction 31 



ENDSEND macro-instruction 35,34 

Entry 

distribution list 50,53 

group code 50,52 

process program 50,53 

single terminal 50-51 

EOA character 37 

EOA macro-^instruction 37 

EOB character 20,21,31,35,39,6 6 

EOB macro-instruction 39 

EOBLC macro-instruction 40 

EODAD 

exit * 4 5 

parameter 55 

EOT character 20,21,44,6 6 

ERRMSG macro-instruction 4 2 

Error checking 7,13,62 

Error condition 62,73 

Error correcting * 13 

Error half-word 43 

Error handling (BTAM) 73-74 

Error handling macro-instructions 

(QTAM) 42-44 

Error information field address 6 6 

Error message, transmission of 11 

Event control block (ECB) 66 

Exit list *. 18,6 3 

Extended binary-coded decimal 
interchange code 26,41 



Fixed record length 16 

Format checking 66 

FREEBUF macro-instruction 7 4 

Functional macro-instructions 36-44 

GET macro- 
instruction 45,12-14,17,18,20,55,56 

Group code 37,4 2 

Header 

prefix 13,32 

scanning . . . 36 

Header, incomplete 43 

Header analysis . 62 

Header analysis error byte 43 

IBM 1Q30 Data Collection System 7,28,41 

IBM 1050 Data Collection 

System 7,28,35,41,42,71 

IBM 2701 Data Adapter Unit 7,75 

IBM Transmission Control 7 

ID list argument 72 

Idle characters 41 

IDLST 

answer 72 

dial 72 

Illegal source code 43 

Initial READ 66 

Initial READ with RESET 6 6 

Initial WRITE 6 8 

Initial WRITE with RESET 6 8 

Input devices 10 

Input message processing queue 22 

Input (process) queues 9-11,44-4 5 

Inquiry application 57-58,7 

Inquiry processing (see also application, 

inquiry processing) * 7,9 
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INTERCPT macro-instruction 44,51 

Interval timer capability 38 

Job management facilities 10 

Job processing *. 9,10 

Job scheduler 9,10,58 

Keyword parameters * 16,62,63 

language 

assembler 11,14 

message control 7 

standard statements 7 

language compiler 14 

language processor .. 9,10 

letters 

lower case 15,41 

upper case «... 15,41 

Library, operating system 10 

line configurations 7 

line control error byte 43 

line error information field 74 

line feed 20,21,45 

Line procedure 

specification 31,44,11-12,16,18 

Line procedures 7 

List argument 

answer * 72 

dial 72 

LIST macro- instruction 28,21,53 

List structure, specification of 72 

Lists 

addressing . 69-70,68 

answering 70,71,72 

distribution 28,37,50,53 

exit *. 18,63 

open 70,71,72 

parameter 24,25,64,65 

polling ... 29-30,11,17,23,47,48,66,69-70 

terminal 12,69-73,66 

wrap-around 70,72 

Local direct-access storage (see 
direct-access storage) 

Logging 14 

LOGSEG macro- instruction 40,55 

Longitudinal redundancy check 43,66 

1PSTART macro- instruction 34 

Macro- instructions 

message processing 12 

system status .... 12,14 

Main storage buffers, size and 

number 11 

Marks, use of punctuation 15 

Mask 42 

Master sequence number 52 

Message, unsolicited 56 

Message buffering storage allocating ... 13 

Message cancelling 13 

Message code translating . - 7 

Message control language (see also 

rout ines ) 7 

Message control macro-instructions, 

summary of 59,61 

Message control program (see also 

routines) 7,9,10,12 

how to construct 9,10 

types of application 9 



Message control routines 7 

Message control sample problem 77-81 

Message control section of BTAM 65-66 

Message control task . 25-44,14-16,21-23 

Message delimiter 66 

Message editing 7,11,13,66 

Message enqueueing and dequeueing 11 

Message format 7,76 

Message handling 

functions 62 

procedure 31 

Message header 32,33 

Message header stamp 38 

Message intercepting 13,44 

Message log 9-11,13,16,26 

Message logging device 22 

Message priority information 13 

Message processing macro-instructions, 

summary of 61 

Message processing 

program 7,9,10,13,14,6 2 

Message processing task .... 44-58,14-16,23 

applications 55-58 

Message queueing 13,22 

Message receiving 7,13,62 

Message rerouting 13 

Message routing 7,11-13,26,37,44,66 

Message segments 45,46,62 

retrieving within priority groups .... 14 

sent as continuous message 14 

Message sending 7,13 

Message sequence number 13 

Message switching (see also application, 

message switching) 55-56,7,9 

10,13,14,75-76 

Message transmitting 62 

Message type 40 

MF keyword parameter 24,25,64,65 

Mode 

conversational 39,66,6 8 

move 19 

MODE macro-instruction 39 

MSGTYPE macro-instruction 40 

Multiple addressing 37 

Multiplex channel 7,75 

Object code 14 

Open list 70,71,72 

Open list argument 70 

OPEN macro-instruction 22-24,64,60-62 

E form 24,6 4 

L form 24,6 4 

message control task use 23 

message processing task use 23 

Operating system library 10 

Operator control 58 

OPTION macro-instruction ... 27,29,30,42,52 

Optional fields 27 

Output message processing queue 22 

Paper tape . 19 

Parameter list 24,25/64,65 

PAUSE macro-instruction 41 

POLL macro-instruction 30 

POLLIMIT macro-instruction 38 

Polling 17,18,51,66,68-69 

characters 28 ,70 

interval 16 
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procedures 7 

terminals 12 

Polling 

list 11,17,23,26,30,47-48,68-69,70 

PCSTRCVE macro-instruction 35 

POSTSEND macro- instruction 36 

Prefix, modified 13 

Printer 19 

Priority 

processing 26 

gueueing 45 

specifications 16 

PROCESS macro-instruction 28-29,21 

Processing program 55-58 

Program , assembler 7 

PUT macro- 
instruction 45-46,12-14,17-19,21 

QSAM (gueued seguential access 

method) 19,23 

QTAM 13-59,7-12 

Queue 

code name of 11 

where required 13 

Queue access 44-45 

Queue status information 54-55 

Queued sequential access method 19,23 

Queued telecommunications access 

method 13-59,7-12 

Quotation marks, when used 27 

RCVF 1050 table 39 

RCVHDR macro- instruction 35,34 

RCVSEG macro- instruction 34,35 

READ 

continued 66 

continued with RESET 66 

conversational 66 

conversational with RESET 66 

initial 66 

initial with RESET 66 

macro- instruction 66-68,63 

repeat 67 

Receive delimiters 34-35 

Receive functional macro- 
instructions 36-38 

Receive or send delimiters 34-35 

Receive or send functional macro- . 

instructions * 38-41 

Receiving messages 12 

Redundance check 

longitudinal 43,66 

vertical 43 

Relative line 

number 16,27,29,47,48,49,67,68 

RELEASED macro-instruction 47,51 

Remote stacked job application 57-58 

Repeat READ 66 

Repolling 66 

REROUTE macro-instruction 44 

RESETPL macro-instruction 69 

Response field, DECB 66 

Response time 7 

Retransmission 67 

RETRIEVE macro-instruction 46,12,29 

ROUTE macro- instruction 37 

Routines 

device handling of QTAM 25 



message control 7 

message editing 7 

message handling of QTAM 25 

(see also message control task) 
Routing messages 13,62 

Sample problem 

basic telecommunications access 

method 8 3 

queued telecommunications access 

method 75 

system configuration 75-83 

Scan pointer 36 

Send delimiters 35 

Send functional macro-instructions 41 

SEND1050 table 41 

SENDHDR macro-instruction 35 

SENDSEG macro-instruction 35 

SEQIN macro-instruction 36 

SEQOUT macro-instruction 41 

Seguence checking 10,13 

Sequence number 

low error 43 

high error 43 

Sequence numbering 10,26 

Sequential input/output devices 14 

Sequential storage device 10 

Service programs 9,10 

SKIP macro- instruction 39 

Source code 

alternate 16 

illegal 43 

SOURCE macro-instruction 36-37 

Source terminal 42 

code 13,36 

code checking 26 

Space allocation 16 

Standard collating sequence >. . . . 12 

Standard language statements 7 

STOPLN macro- instruction 48-49 

STRTLN macro-instruction 48,24,31 

System configuration 

BTAM 83 

QTAM 75 

System specifications 62 

System status changing 62 

Tape density 19 

Tape units 10 

Task 7 

Task management facilities 9,10 

Telecommunications program, 

constructing of 12 

Telecommunications system specifications 

macro-instructions 59 

Telecommunications system 

status 44,47-50 

Tele-processing application 7 

Tele-processing output writer 58 

Tele-processing reader/interpreter 58 

TERM macro-instruction 27-28 

Terminal addressing 12,13,26,62 

Terminal code, name and address of 11 

Terminal entry, single 50-51 

Terminal list 66,71 

address of 69 

changing status of 12 

facilities for creating 12 
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structure of 70 

Terminal polling 13,26,62 

Terminal table 26-29 

entry 50-53 

specification, macro- 

instruction for 69 

Terminal response character 73 

TERMTEL macro- instruction 26-27 

Text 

prefix 13,32 

segment 32 

Time stamp 38-39 

Time stamping 13,14,26,62 

TIWESTNP macro-instruction 38-39 

TRANS macro-instruction 40-41 

Transaction processing 7,9 

Translating 40-41 

Transmission error 43 

Unsolicited message 55 

Variable 



length blocked records 19 

length field 36 

length message 13 

length records 19 

Vertical redundance check 43 

WAIT macro-instruction 64-65 

WAITR macro-instruction 64-65 

Western Union Plan 115A Outstations 7 

Workarea 45-47 

Wrap-around 

list 70 

list argument 72 

WRITE 

continued 6 8 

continued with RESET 68 

conversational 68 

conversational with RESET 6 8 

initial 68 

initial with RESET 6 8 

macro-instruction 68-69 



Index 



91 



READER'S COMMENTS 
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